GatifyAI
문서

API 레퍼런스

GatifyAI는 OpenAI SDK와 호환되는 채팅 완성(chat completions) 엔드포인트를 제공합니다 — 기존에 사용하던 OpenAI 클라이언트를 GatifyAI로 지정하기만 하면 특별한 클라이언트 라이브러리 없이 바로 작동합니다.

기본 URL

모든 요청은 다음으로 전송됩니다:

https://gatifyai.com/api/v1

인증

API 키 페이지에서 키를 생성한 다음, Authorization 헤더에 베어러 토큰으로 전송하세요. 키의 해시값만 저장되므로 생성 시 반드시 복사해 두세요 — GatifyAI는 이후 다시 보여줄 수 없습니다.

빠른 시작

curl, Python, TypeScript로 작성한 최소 요청 예시:

curl https://gatifyai.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

키를 특정 모델로 제한하기

기본적으로 새 키는 GatifyAI의 모든 무료 모델을 사용할 수 있으며, 모델을 사용할 수 없을 때는 웹 채팅과 동일한 자동 장애 전환이 적용됩니다. 대신 키를 특정 모델이나 짧은 목록으로 제한할 수도 있습니다 — 이 경우 요청이 어떤 모델을 지정하든 상관없이, 지정한 순서대로 해당 목록의 모델만 사용됩니다. 목록에 없는 모델을 요청하면 키가 실제로 사용할 수 있는 모델을 알려주는 400 오류가 반환됩니다.

페르소나로 채팅하기

model: "persona/<slug>"를 전달하면 커뮤니티 갤러리에 공개된 페르소나로 채팅할 수 있습니다 — 해당 페르소나의 성격과 선호 모델이 자동으로 적용되며, 키에 허용 모델을 설정한 경우 그 제한도 그대로 적용됩니다. 페르소나의 slug와 바로 사용할 수 있는 예제는 해당 페르소나 페이지의 API 탭에서 확인할 수 있습니다.

{
  "model": "persona/senior-engineer",
  "messages": [{"role": "user", "content": "Review my code."}]
}

스트리밍과 비스트리밍

stream: true로 설정하면 OpenAI의 스트리밍 형식(Server-Sent Events, [DONE]으로 종료)과 동일하게 토큰이 생성되는 즉시 수신됩니다. 이 옵션을 생략하거나 false로 설정하면 전체 응답을 기다린 후 하나의 JSON 응답을 받게 되며, 이것이 기본 동작입니다.

오류

오류는 OpenAI의 오류 형식을 따릅니다: {"error": {"message": "...", "type": "..."}}. 401은 키가 없거나, 유효하지 않거나, 취소되었음을 의미합니다. 400은 요청 자체가 유효하지 않음을 의미합니다 — 대개 인식할 수 없는 모델, 공개되지 않았거나 알 수 없는 페르소나 slug, 또는 키의 허용 목록에 없는 모델일 때 발생합니다. 502는 후보 모델이 모두 응답하지 않았음을 의미합니다.

{
  "error": {
    "message": "This API key may only use: llama-3.1-8b:free",
    "type": "invalid_request_error"
  }
}

요청 한도

API 요청은 웹 앱과 동일하게 계정별 채팅 요청 한도에 포함되어 계산됩니다 — 현재 API 트래픽에 대한 별도의 할당량은 없습니다.