API Responses và Codex - NexusAPI

Trong NexusAPI, /v1/responses dành cho custom provider trong hướng dẫn Codex CLI và cho model có supported_endpoint_types trong /v1/models chứa openai-response.

Xác nhận giao thức được hỗ trợ trướcTrước khi dùng /v1/responses, hãy xác nhận supported_endpoint_types có openai-response. Nếu gặp status_code=500, not implemented, chuyển sang giao thức được liệt kê cho model đó và thực hiện một kiểm tra ngắn.

Endpoint và phạm vi

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

Tình huống	Cách nên dùng
Codex CLI	Dùng cấu hình Provider `wire_api = "responses"` trong hướng dẫn Codex CLI
Ứng dụng khác có model mà `supported_endpoint_types` chứa `openai-response`	Dùng Responses client/schema của ứng dụng và kiểm tra yêu cầu tối thiểu trước
Ứng dụng văn bản tương thích OpenAI thông thường	Dùng Chat Completions; không chuyển chỉ vì API này mới hơn
Model không có `openai-response`	Dùng Chat Completions hoặc Messages được nêu trong `supported_endpoint_types`, không dùng endpoint này

Yêu cầu kiểm tra tối thiểu

Chỉ sau khi xác nhận model hỗ trợ, kiểm tra kết nối bằng:

curl 'https://nexusapi.link/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "model": "YOUR_RESPONSES_MODEL_ID",
    "input": "Chỉ trả lời: kết nối thành công"
  }'

input không giống messages của Chat Completions và phản hồi không nên được đọc là choices[0].message. Xem schema chính thức của client để biết đầy đủ trường, sự kiện streaming và cấu trúc kết quả.

Điểm chính khi cấu hình 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 trong biến môi trường NEXUSAPI_API_KEY, không ghi vào config.toml hoặc auth.json. Xem hướng dẫn Codex CLI để cài đặt, biến môi trường từng hệ điều hành và kiểm tra.

Kiểm tra đầu tiên

Nhóm key chứa model và model ID khớp chính xác với Chợ mô hình.
Client thực sự gọi /v1/responses, không phải /v1/v1/....
supported_endpoint_types của model chứa openai-response; nếu không, dùng giao thức tương ứng được liệt kê.
Lưu Request ID, phiên bản client và toàn bộ lỗi, sau đó làm theo tự kiểm tra.