Responses API

POST /v1/responses

Responses API 适合需要统一文本、工具、多模态输入输出的新版调用方式，也常用于 Codex 类工具。实际支持范围以控制台模型能力为准。

Base URL

OpenAI SDK 使用：

https://portdan.com/v1

Codex / CC Switch 类工具通常使用根地址：

https://portdan.com

Sub2 同时提供 /v1/responses、/responses 和 /backend-api/codex/responses 路由，便于不同客户端拼接。

请求示例

curl https://portdan.com/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "请用一句话说明 API Key 为什么不能公开。"
  }'

JavaScript 示例

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.PORTDAN_API_KEY,
  baseURL: 'https://portdan.com/v1'
})

const response = await client.responses.create({
  model: 'gpt-5.5',
  input: '请只回复 OK'
})

console.log(response.output_text)

Codex 配置示例

~/.codex/config.toml：

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
disable_response_storage = true
network_access = "enabled"

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://portdan.com"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-your-api-key"
}

这里的 Key 仍然原样使用，不加后缀。

与 Chat Completions 的选择

场景	建议接口
现有图形客户端或旧代码	Chat Completions
需要最大兼容性	Chat Completions
新项目且 SDK 支持 Responses	Responses
Codex 类工具	Responses，按工具配置要求使用根地址或 /v1

不支持时怎么办

如果返回 404、unsupported_endpoint 或类似错误，说明当前模型、分组或客户端拼接方式不匹配。先确认：

1. Base URL 是否按客户端类型填写。
2. Key 是否没有后缀。
3. 模型名是否在 /models 返回中。
4. 当前分组是否支持 Responses。