OpenAI · Responses

使用 input 发起 Responses 请求,适用于支持该协议的模型和渠道。

POST/v1/responses
https://api.hanrouter.ai/v1管理 API Key

地址与认证

OpenAI 兼容客户端的 Base URL 为 https://api.hanrouter.ai/v1,请求头为 Authorization: Bearer $HANROUTER_API_KEY。不要重复拼接 /v1。所有厂商都使用本站密钥,不需要向客户端填写上游厂商密钥。

Anthropic SDK 与 Claude Code 的 Base URL 使用 https://api.hanrouter.ai(不含 /v1),由客户端拼接 /v1/messages。Google 模型优先使用本站 OpenAI 兼容接口。

响应格式

读取 output 中的消息及 output_text 内容块;Responses 流式事件与 Chat Completions 的 delta 不同,应按事件 type 解析。模型及渠道必须支持 Responses,不应将所有文本模型都假定为支持。

请求参数

model
必填 string:当前 Key 可用的准确模型 ID。
input
必填:输入文本或该协议允许的内容数组。
stream
可选 boolean:启用 SSE 增量输出,默认 false。

请求示例

示例采用当前目录中的模型 ID。实际可调用范围取决于 API Key 的分组权限,请先查询 GET /v1/models。

cURL
curl -X POST "https://api.hanrouter.ai/v1/responses" \
  -H "Authorization: Bearer $HANROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "your-model-id",
  "input": "Hello"
}'

响应示例

JSON · 结构示例
{
  "object": "response",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello!"
        }
      ]
    }
  ]
}