Интеграция GPT-5.1 Codex API
Используйте GPT-5.1 Codex через Rivya Public API v1: model id gpt-5-1-codex-chat, поддерживаемые входные данные, параметры, правила Files API, кредиты и примеры ответов.
gpt-5-1-codex-chat
text, file
Не требуется для минимального запроса
3
Чат
Chat API: обычный режим + SSE streaming
TOKEN_BASED
20000 символов
Контракт запроса
Chat-запросы отправляют по одному сообщению за раз. История сессии хранится в Rivya; не отправляйте сырой массив messages.
| Ключ | Тип | Обязательно | По умолчанию | Описание |
|---|---|---|---|---|
| model | string | Да | gpt-5-1-codex-chat | Используйте gpt-5-1-codex-chat как API model id. |
| session_id | string | Нет | - | Необязательный id чат-сессии, созданной через API. Не указывайте его, чтобы начать новую сессию. |
| message | string | Да | - | Следующее сообщение пользователя. История Chat API берется из серверной сессии, а не из сырого массива messages. |
| attachments | array | Нет | - | Необязательные значения file_id для изображений, возвращенные Files API. Внешние URL вложений не принимаются. |
| enable_web_search | boolean | Нет | false | Применяется только если выбранная чат-модель поддерживает веб-поиск. |
| reasoning_effort | string | Нет | default | Необязательная глубина рассуждения: default, minimal, low, medium, high или xhigh, если модель это поддерживает. |
| client_request_id | string | Нет | - | Необязательный клиентский id для трассировки запросов в вашей системе. |
Параметры модели
Эта чат-модель использует общие поля Chat API выше. Поддержка веб-поиска, вложений с файлами изображений, мыслей и reasoning отражена в данных readiness.
Минимальный запрос
{
"model": "gpt-5-1-codex-chat",
"message": "Write a concise launch plan for a new product image campaign"
}Запрос с reference-файлом
{
"model": "gpt-5-1-codex-chat",
"message": "Write a concise launch plan for a new product image campaign",
"attachments": [
{
"file_id": "file_uploaded_image_id"
}
]
}Ответ создания
Эндпоинт Chat возвращает готовое сообщение assistant, использование токенов и финальное списание кредитов за этот ход.
{
"id": "chatcmpl_msg_gpt_5_1_codex_chat_example",
"object": "chat.completion",
"session_id": "chat_session_gpt_5_1_codex_chat",
"model": "gpt-5-1-codex-chat",
"created_at": "2026-05-11T00:00:00.000Z",
"message": {
"id": "assistant_message_id",
"role": "assistant",
"content": "A concise launch plan with clear next steps."
},
"usage": {
"input_tokens": 1200,
"output_tokens": 320,
"total_tokens": 1520
},
"credits": {
"reserved": 3,
"final": 3
}
}Распространенные ошибки
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported
Chat API в Public API v1 поддерживает обычные и SSE streaming ходы. Вложения изображений должны использовать значения file_id из Files API.