Chat Completions API
POST /v1/chat/completions — Cursor, LangChain, LiteLLM 및 OpenAI SDK용 OpenAI 형식 엔드포인트.
OpenAI 호환 인터페이스입니다. 모델과 가격은 같고, 메시지를 감싸는 구조만 다릅니다.
엔드포인트
POST https://aiprimetech.io/v1/chat/completionsSDK용 기본 URL
https://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 |
|---|---|---|
| 시스템 프롬프트 | 최상위 system | messages[0] system 역할 사용 |
| 응답 텍스트 | content[0].text | choices[0].message.content |
| 중단 이유 | stop_reason | finish_reason |
| 입력 토큰 | usage.input_tokens | usage.prompt_tokens |
| 출력 토큰 | usage.output_tokens | usage.completion_tokens |
| 스트림 델타 | content_block_delta | choices[0].delta.content |