POSTOpenAI
/chat/completionsCreate Chat Completion
Creates a model response from conversation history with streaming, tools, and usage accounting.
Аутентификация
Используйте API-ключ с Authorization: Bearer sk-xxxx.
Authorization: Bearer sk-xxxx
Тип содержимого
application/json
Примеры моделей
gpt-4o, gpt-4.1, gpt-5, o3, o4-mini
Пример запроса
{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": "Hello"
}
],
"stream": false
}Пример ответа
{
"id": "chatcmpl_xxx",
"object": "chat.completion",
"created": 0,
"model": "gpt-4o",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello!"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 8,
"completion_tokens": 3,
"total_tokens": 11
}
}curl Example
curl -X POST 'https://costrouter.ai/v1/chat/completions' \
-H 'Authorization: Bearer sk-xxxx'
-H 'Content-Type: application/json'
-d '{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": "Hello"
}
],
"stream": false
}'Параметры
| Название | Тип | Обязательно | Описание |
|---|---|---|---|
| model | string | Да | Model ID. The CostRouter selects an available channel by model name and forwards the request. |
| messages | array<object> | Да | Conversation message array, usually with system, user, assistant, or tool roles. |
| temperature | number | Нет | Sampling temperature. Higher values make output more random. |
| top_p | number | Нет | Nucleus sampling parameter, usually adjusted instead of temperature. |
| stream | boolean | Нет | Whether to return a streaming response. |
| max_tokens | integer | Нет | Максимальное число выходных токенов. |
| tools | array<object> | Нет | Tool or function definitions. Support depends on the upstream model. |
| response_format | object | Нет | Structured response format. Support depends on the upstream model. |
Пример ответа
| Название | Тип | Обязательно | Описание |
|---|---|---|---|
| id | string | Нет | Response, task, or resource ID. |
| object | string | Нет | Response object type. |
| created | integer | Нет | Creation timestamp. |
| model | string | Нет | - |
| choices | array<object> | Нет | Candidate model outputs. |
| usage | object | Нет | Token usage statistics. |