GPT Chat Completions

BeatAPI 키 하나로 OpenAI Chat Completions 엔드포인트에서 GPT-6.1 Terra, GPT-6.1 Sol, GPT-6 Astra, GPT-6 Sol, GPT-6 Luna를 호출합니다.

• 현재 모든 GPT 모델이 엔드포인트 POST /v1/chat/completions 하나를 사용합니다. model만 바꿔 전환하세요.
• 텍스트·이미지 입력, 텍스트 출력, 스트리밍, 구조화된 출력, 추론 강도 설정. GPT-6.1 Terra와 Sol의 도구 호출에는 Responses가 필요합니다.
• OpenAI SDK와 호환됩니다. 기본 URL을 바꾸고 BeatAPI 키를 사용하세요.
• 추론과 도구 호출을 새로 연동한다면 OpenAI Responses 형식을 권장합니다.

API Explorer에서 이 엔드포인트를 엽니다. BeatAPI API 키를 입력하고 전송하세요. 실제 호출이며 본인 잔액에서 과금됩니다.

모델

model에 다음 ID 중 하나를 보내세요. 각각 별개의 모델이며, 서로의 별칭으로 취급하지 마세요.

• 가격은 할인이 적용된 기본 등급입니다. 롱 컨텍스트 등급, 캐시 입력 요금, 캐시 쓰기는 이 표에 없습니다. 가격표를 참고하세요.
• —는 카탈로그에서 해당 수치를 공개하지 않는다는 뜻입니다.

이 계열의 이전 ID도 계속 동작하며 레거시 모델에 나와 있습니다.

빠른 시작

서버에 openai 패키지를 설치하고 키는 BEATAPI_API_KEY에 보관하세요. 브라우저 코드에는 절대 넣지 마세요. 아래는 요청 예시이며 실제로 기록된 모델 출력이 아닙니다.

choices[0].message.content에서 답변을 읽은 다음 finish_reason과 usage를 확인하세요. HTTP 200만으로는 답변이 작업 요구를 충족한다고 볼 수 없으니 애플리케이션에서 검증하세요. 텍스트 요청은 바로 반환되므로 /v1/tasks를 폴링하지 마세요.

curl --request POST \
  --url https://direct.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-6-luna",
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'

엔드포인트와 인증

POST https://direct.beatapi.io/v1/chat/completions

요청 파라미터

표준 OpenAI Chat Completions 필드를 받습니다. 요청 형식이 호환된다고 해서 모든 제조사별 옵션이나 도구가 지원되는 것은 아니므로, 사용하는 옵션은 직접 테스트하세요.

응답

스트리밍하지 않는 호출은 JSON 객체 하나를 반환합니다. 아래는 축약한 예시입니다.

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "gpt-6-luna",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Retry with exponential backoff and jitter, and make every handler idempotent."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 16,
    "total_tokens": 35
  }
}

응답 필드

스트리밍

"stream": true를 설정하세요. BeatAPI는 서버 전송 이벤트 스트림을 변환하지 않고 전달하므로, 이벤트 객체는 OpenAI SDK와 호환됩니다.

• 응답은 text/event-stream이며, 스트리밍하지 않으면 application/json입니다.
• 모델 호출 전에 발생한 실패는 스트림 이벤트가 아니라 HTTP 상태와 함께 일반 JSON 오류로 반환됩니다.
• 명시적인 시간 제한을 설정하고, 스트리밍 응답은 안전하게 다시 연결하세요.

data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Retry"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" with backoff"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

오류

HTTP 오류 요약

인증, 라우팅, 요청 속도 제한, 알 수 없는 모델 실패는 모델 호출 전에 BeatAPI 오류 형식(error.code, error.message, retryable, request_id)으로 응답합니다. 그 밖의 모든 실패는 OpenAI SDK 형식 {"error": {"message", "type", "code"}}를 유지하며, 코드는 error.code에 있고 요청 id는 message로 끝납니다. 오류를 참고하세요.

전체 코드 표와 재시도 정책: 오류.

참고

• GPT 모델은 OpenAI Responses에서도 응답합니다.
• 입력 토큰이 272K를 넘으면 gpt-6.1-terra, gpt-6.1-sol, gpt-6-astra는 요청 전체에 상위 등급을 적용합니다. 롱 컨텍스트 워크로드의 예산을 잡기 전에 가격표를 확인하세요.
• API 키는 신뢰할 수 있는 서버에 두고, 응답의 요청 ID를 기록하며, 429, 500, 503만 재시도하세요.