Source: https://aiprimetech.io/ko/docs/api-reference/chat-completions/

[홈](/ko/) / [문서](/ko/docs/) / Chat Completions API 

# Chat Completions API 

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

 페이지 복사 [ Markdown으로 보기](/ko/docs/api-reference/chat-completions.md) [ ChatGPT에 질문](https://chatgpt.com/?q=Read%20https%3A//aiprimetech.io/docs/api-reference/chat-completions.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.) [ Claude에서 질문](https://claude.ai/new?q=Read%20https%3A//aiprimetech.io/docs/api-reference/chat-completions.md%20and%20answer%20questions%20about%20it.%20Start%20with%20a%20short%20summary.)   

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 필드를 이 엔드포인트로 보내지 마세요. 

## 예시 

```
Copycurl 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"}]
  }'
```

## 응답 

```
Copy{
  "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 사용 

```
Copyfrom 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 

[Cursor이 엔드포인트에 연결하도록 Cursor 설정](/ko/docs/guides/cursor/)[OpenAI에서 마이그레이션기존 코드베이스 전환](/ko/docs/guides/migration-from-openai/)[스트리밍두 형식의 SSE](/ko/docs/api-reference/streaming/) 

[이전Messages API](/ko/docs/api-reference/messages/)[다음모델 엔드포인트](/ko/docs/api-reference/models-endpoint/)