API Responses и Codex - NexusAPI 文档中心

/v1/responses — не универсальный «новый API чата». В NexusAPI он предназначен прежде всего для кастомного Provider из руководства Codex CLI, либо для модели, группы key и канала, явно подтверждённых для протокола Responses.

Сначала подтвердите модель и каналНе используйте /v1/responses для текущих Anthropic-типов Claude. При status_code=500, not implemented используйте Chat Completions или нативную конфигурацию Messages в Claude Code.

Endpoint и область применения

POST https://nexusapi.link/v1/responses

Сценарий	Рекомендуемый подход
Codex CLI	Используйте Provider `wire_api = "responses"` из руководства Codex CLI
Другое приложение с подтверждённой моделью Responses	Используйте его Responses client/Schema и сначала проверьте минимальный запрос
Обычное OpenAI-совместимое текстовое приложение	Используйте Chat Completions; не переключайтесь лишь из-за новизны API
Anthropic-тип Claude	Используйте Messages или Chat Completions, не этот endpoint

Минимальный запрос для проверки

Только после подтверждения модели и канала проверьте связь так:

curl 'https://nexusapi.link/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "YOUR_RESPONSES_MODEL_ID",
    "input": "Ответьте только: соединение успешно"
  }'

input — не то же поле, что messages в Chat Completions; ответ нельзя разбирать как choices[0].message. Полные поля, streaming-события и структуру результата смотрите в справочнике API Apifox или официальной Schema клиента.

Основные настройки Codex CLI

model_provider = "nexusapi"
model = "YOUR_MODEL_ID"

[model_providers.nexusapi]
base_url = "https://nexusapi.link/v1"
env_key = "NEXUSAPI_API_KEY"
wire_api = "responses"

Храните key в переменной окружения NEXUSAPI_API_KEY, а не в config.toml или auth.json. Установка, переменные ОС и проверка приведены в руководстве Codex CLI.

Что проверить сначала

Группа key содержит модель, а ID полностью совпадает с каталогом.
Клиент действительно обращается к /v1/responses, а не /v1/v1/....
Модель подтверждена для Responses; для Anthropic-type Claude выберите другой протокол.
Сохраните Request ID, версию клиента и полный текст ошибки, затем выполните самопроверку.