Responses API

OpenAI Responses API 是 Codex CLI / Codex App 及新版 OpenAI SDK 所使用的协议。XycAi 原生转发该协议 —— 同时支持普通 HTTP 与 WebSocket —— 因此只需一个 XycAi 密钥，Codex 即可开箱即用。

请求示例

curl https://apicdn.xyc.ai/v1/responses \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Write a haiku about the sea.",
    "stream": true
  }'

使用官方 OpenAI SDK：

from openai import OpenAI

client = OpenAI(base_url="https://apicdn.xyc.ai/v1", api_key="sk-xxxxxxxx")

resp = client.responses.create(
    model="gpt-5.5",
    input="Write a haiku about the sea.",
)
print(resp.output_text)

在 Codex CLI / Codex App 中使用

运行我们的一键命令自动完成 Codex 配置（会写入 ~/.codex/config.toml 与 auth.json）：

npx xycai@latest

或在 ~/.codex/config.toml 中手动配置：

model_provider = "xycai"
model = "gpt-5.5"
preferred_auth_method = "apikey"

[model_providers.xycai]
name = "xycai"
base_url = "https://apicdn.xyc.ai/v1"
wire_api = "responses"
requires_openai_auth = false
http_headers = { "x-openai-actor-authorization" = "xyc.ai" }

WebSocket 模式

对于通过 WebSocket 使用 Responses API 的客户端（较新的 Codex 版本），使用 wss:// 连接同一路径即可 —— 网关会透明地将 WS 桥接到 HTTP：

wss://apicdn.xyc.ai/v1/responses

推荐模型

gpt-5.6-sol、gpt-5.6-luna、gpt-5.6-terra、gpt-5.5、gpt-5.4、gpt-5.4-mini，以及 gpt-5.x-codex 系列。详见模型列表。

响应结构

{
  "id": "resp_xxxxxxxx",
  "object": "response",
  "model": "gpt-5.5",
  "output": [
    {"type": "message", "role": "assistant", "content": [{"type": "output_text", "text": "..."}]}
  ],
  "usage": {"input_tokens": 12, "output_tokens": 40}
}