API Responses и Codex - NexusAPI

В NexusAPI /v1/responses предназначен для custom provider из руководства Codex CLI и для моделей, у которых supported_endpoint_types в /v1/models содержит openai-response.

Сначала подтвердите поддерживаемый протоколПеред использованием /v1/responses убедитесь, что supported_endpoint_types содержит openai-response. При status_code=500, not implemented переключитесь на протокол, указанный для этой модели, и выполните короткий тест.

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

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

Сценарий	Рекомендуемый подход
Codex CLI	Используйте Provider `wire_api = "responses"` из руководства Codex CLI
Другое приложение с моделью, у которой `supported_endpoint_types` содержит `openai-response`	Используйте его Responses client/Schema и сначала проверьте минимальный запрос
Обычное OpenAI-совместимое текстовое приложение	Используйте Chat Completions; не переключайтесь лишь из-за новизны API
Модель без `openai-response`	Используйте протокол Chat Completions или Messages, указанный в `supported_endpoint_types`, а не этот 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-события и структуру результата смотрите в официальной 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/....
supported_endpoint_types модели содержит openai-response; если нет, используйте указанный совместимый протокол.
Сохраните Request ID, версию клиента и полный текст ошибки, затем выполните самопроверку.