Чат-завершения
Запрос и ответ для POST /v1/chat/completions.
Чат-завершения
Запрос
POST https://apimaster.ai/v1/chat/completions
Заголовки
| Заголовок | Обязательный | Примечания |
|---|---|---|
Authorization |
Да | Bearer YOUR_API_KEY |
Content-Type |
Да | application/json |
Тело (общие поля)
| Поле | Тип | Примечания |
|---|---|---|
model |
string | например, claude-sonnet-4-6 |
messages |
array | {role, content} |
max_tokens |
number | Максимальное количество токенов завершения |
temperature |
number | Необязательно |
stream |
boolean | SSE-потоковая передача |
Пример
curl -s "https://apimaster.ai/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "system", "content": "You are helpful."},
{"role": "user", "content": "Say hi in one word."}
],
"max_tokens": 64
}'
Непотоковый ответ
{
"id": "chatcmpl-...",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "..." },
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 5,
"total_tokens": 15
}
}
Потоковая передача
При "stream": true тело имеет тип text/event-stream; строки имеют формат data: {json} до тех пор, пока не появится data: [DONE].
Коды состояния
| Код | Значение |
|---|---|
| 400 | Некорректные параметры |
| 401 | Ошибка аутентификации |
| 402 / 403 | Квота или разрешение |
| 429 | Превышение лимита запросов |
| 502 / 503 | Ошибка вышестоящего сервиса — повторите попытку |