OpenAI Responses API

仅当客户端或 Agent 工具明确要求 OpenAI Responses API wiring 时，使用 /openai/v1/responses。

Responses API 路由用于已经依赖 OpenAI 新 responses wire format 的客户端，尤其是一些不再直接使用 Chat Completions 的 Agent 编码工具或 SDK。

普通应用聊天优先使用兼容 OpenAI。只有当工具明确要求 Responses API base URL 或 wire_api = "responses" 时，再使用本页。

状态

Beta。非流式路由已经本地冒烟验证。流式兼容性取决于具体客户端和模型路径，生产前请在目标账号中验证。

Base URL

https://api.anyint.ai/openai/v1

路由

路由	用途
`POST /responses`	创建 response
`GET /responses/{response_id}`	当上游路径支持时，按 ID 获取 response

认证

Authorization: Bearer <ANYINT_API_KEY>
Content-Type: application/json

最小请求

请求字段

字段	类型	必填	含义	示例
`model`	字符串	是	当前账号可用的模型 ID。请先调用 Models API。	`claude-sonnet-4-6`
`input`	字符串或数组	是	response 的用户输入。简单提示词使用字符串，兼容客户端可使用结构化 input items。	`Reply with exactly: OK`
`stream`	布尔值	否	当所选模型路径和客户端支持时，请求流式响应。生产前请验证。	`false`
`instructions`	字符串	否	response 的系统风格指令。	`Be concise.`
`tools`	数组	否	所选模型支持时，Responses 兼容客户端使用的工具定义。	`[{"type":"function",...}]`
`tool_choice`	字符串或对象	否	提供工具时控制工具使用。	`auto`
`temperature`	数字	否	采样随机性。	`0.7`
`top_p`	数字	否	nucleus sampling 控制项。	`1`
`max_output_tokens`	整数	否	Responses 兼容客户端使用的最大输出 token 数。	`512`
`metadata`	对象	否	客户自定义追踪元数据。不要放 API key 或私密凭证。	`{"workflow":"codex"}`

curl https://api.anyint.ai/openai/v1/responses \
  -H "Authorization: Bearer $ANYINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "input": "Reply with exactly: OK"
  }'

响应字段

字段	含义
`id`	Response 标识符
`object`	兼容路径返回时的响应对象类型
`status`	兼容路径返回时的响应状态
`model`	处理请求的模型
`output`	返回时的结构化输出项
`output_text`	兼容路径返回时的扁平文本输出
`usage`	可用时的 token 使用情况
`error`	兼容路径返回失败 response 时的错误对象

获取 response

仅当创建响应返回了 response ID，且所选路径支持查询时使用。

curl https://api.anyint.ai/openai/v1/responses/$RESPONSE_ID \
  -H "Authorization: Bearer $ANYINT_API_KEY"

Codex CLI 示例

[profiles.anyint]
model_provider = "anyint"
model = "<MODEL_ID>"

[model_providers.anyint]
name = "AnyInt"
base_url = "https://api.anyint.ai/openai/v1"
env_key = "ANYINT_API_KEY"
wire_api = "responses"

然后运行：

export ANYINT_API_KEY="your-anyint-api-key"
codex exec --profile anyint "Reply exactly OK."

常见错误

普通 OpenAI SDK 聊天集成误用 Responses API，而不是更简单的 /chat/completions
假设所有 Agent 工具和所有模型都已经验证流式 Responses 兼容性
把 base URL 配成 /openai/v1/responses，而不是 /openai/v1
未先通过模型 API 查询模型 ID

状态