> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Chat Completions
> - 대화 기록을 기반으로 모델 응답을 생성합니다. 스트리밍 및 비스트리밍 응답을 지원합니다.
- OpenAI Chat Completions API와 호환됩니다.
```bash cURL theme={null} theme={null}
curl --request POST \
--url 'https://api.elkapi.com/v1/chat/completions' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "안녕하세요, 자기소개를 해 주세요"
}
],
"temperature": 1,
"stream": false,
"max_tokens": 1024,
"response_format": "json"
}'
```
```python Python theme={null} theme={null}
import requests
url = "https://api.elkapi.com/v1/chat/completions"
headers = {
"Authorization": "Bearer "
}
headers["Content-Type"] = "application/json"
payload = {
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "안녕하세요, 자기소개를 해 주세요"
}
],
"temperature": 1,
"stream": False,
"max_tokens": 1024,
"response_format": "json"
}
response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())
```
```javascript JavaScript theme={null} theme={null}
const url = "https://api.elkapi.com/v1/chat/completions";
const headers = {
"Authorization": "Bearer "
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "안녕하세요, 자기소개를 해 주세요"
}
],
"temperature": 1,
"stream": false,
"max_tokens": 1024,
"response_format": "json"
};
const response = await fetch(url, {
method: "POST",
headers,
body: JSON.stringify(payload)
});
console.log(await response.json());
```
```json 200 theme={null} theme={null}
{
"id": "id",
"object": "chat.completion",
"created": 1,
"model": "gpt-5.5",
"choices": [
{
"index": 1,
"message": {
"role": "user",
"content": "안녕하세요, 자기소개를 해 주세요",
"name": "name",
"tool_calls": [
{
"id": {},
"type": {},
"function": {}
}
],
"tool_call_id": "tool_call_id",
"reasoning_content": "reasoning_content"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 1,
"completion_tokens": 1,
"total_tokens": 1,
"prompt_tokens_details": {
"cached_tokens": 1,
"text_tokens": 1,
"audio_tokens": 1,
"image_tokens": 1
},
"completion_tokens_details": {
"text_tokens": 1,
"audio_tokens": 1,
"reasoning_tokens": 1
}
},
"system_fingerprint": "system_fingerprint"
}
```
```json 400 theme={null} theme={null}
{
"error": {
"message": "message",
"type": "type",
"param": "param",
"code": "code"
}
}
```
```json 429 theme={null} theme={null}
{
"error": {
"message": "message",
"type": "type",
"param": "param",
"code": "code"
}
}
```
## Authorizations
모든 엔드포인트는 Bearer Token 인증이 필요합니다.
요청 헤더에 추가하세요:
```
Authorization: Bearer YOUR_API_KEY
```
## Body
모델 ID
예시: `gpt-5.5`
채팅 메시지 목록
메시지 역할
허용 값: `system`, `user`, `assistant`, `tool`, `developer`
메시지 내용
발신자 이름
예시: `function`
도구 호출 ID(tool 역할 메시지용)
추론 내용
샘플링 온도
뉴클리어스 샘플링 파라미터
생성 수
스트리밍 응답 여부
중지 시퀀스
최대 생성 토큰 수
최대 완성 토큰 수
예시: `function`
JSON Schema 형식의 파라미터 정의
허용 값: `text`, `json_object`, `json_schema`
JSON Schema 정의
추론 강도(추론 지원 모델용)
허용 값: `low`, `medium`, `high`
## Response
예시: `chat.completion`
예시: `gpt-5.5`
메시지 역할
허용 값: `system`, `user`, `assistant`, `tool`, `developer`
메시지 내용
발신자 이름
예시: `function`
도구 호출 ID(tool 역할 메시지용)
추론 내용
허용 값: `stop`, `length`, `tool_calls`, `content_filter`
프롬프트 토큰 수
완성 토큰 수
총 토큰 수