홈 / 문서 / Chat Completions API

Chat Completions API

POST /v1/chat/completions — Cursor, LangChain, LiteLLM 및 OpenAI SDK용 OpenAI 형식 엔드포인트.

OpenAI 호환 인터페이스입니다. 모델과 가격은 같고, 메시지를 감싸는 구조만 다릅니다.

엔드포인트POST https://aiprimetech.io/v1/chat/completions
SDK용 기본 URLhttps://aiprimetech.io/v1 — /v1에 유의하세요
인증Authorization: Bearer sk-...

요청 본문

항목유형필수 여부설명
model문자열예다음에서 제공하는 모든 ID /v1/models, Claude ID 포함
messages배열예system, user 및 assistant 역할 지원
max_tokens정수아니요Messages API와 달리 여기서는 선택 사항
temperature숫자아니요OpenAI 규칙에 따른 0–2
stream불리언아니요SSE 청크를 받으려면 true
tools배열아니요OpenAI 함수 호출 구조
Messages와 달리, system 은 여기서 역할입니다 — 다음의 첫 번째 항목으로 넣으세요: messages. 최상위 system 필드를 이 엔드포인트로 보내지 마세요.

예시

curl https://aiprimetech.io/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDEAPIKEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

응답

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "claude-sonnet-4-6",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "..."},
    "finish_reason": "stop"
  }],
  "usage": {"prompt_tokens": 9, "completion_tokens": 12, "total_tokens": 21}
}

OpenAI SDK 사용

from openai import OpenAI

client = OpenAI(
    api_key=class="s">"sk-your-key",
    base_url=class="s">"https://aiprimetech.io/v1",   class=class="s">"c"># the /v1 matters
)

resp = client.chat.completions.create(
    model=class="s">"claude-sonnet-4-6",
    messages=[{class="s">"role": class="s">"user", class="s">"content": class="s">"Hello"}],
)
print(resp.choices[0].message.content)

두 형식 간 필드 매핑

개념메시지Chat Completions
시스템 프롬프트최상위 systemmessages[0] system 역할 사용
응답 텍스트content[0].textchoices[0].message.content
중단 이유stop_reasonfinish_reason
입력 토큰usage.input_tokensusage.prompt_tokens
출력 토큰usage.output_tokensusage.completion_tokens
스트림 델타content_block_deltachoices[0].delta.content