OpenAI Responses

OpenAI 新版 Responses 接口，适合已经使用 responses.create 或新版 OpenAI SDK 的项目。

兼容性提示 (中转平台与旧版 SDK)

本接口（/v1/responses）是 OpenAI 官方较新推出的协议格式。

1. 中转平台支持度： 部分较老版本的 New API / One API 中转系统可能尚未跟进此接口的转发。
2. 客户端与 SDK 支持度： 仅在使用支持新版 responses 协议的官方 SDK 时方可调用，旧版客户端和通用第三方软件可能无法识别该格式。

建议： 如果您的中转平台或客户端在请求时报错，或者不支持新版 Responses 协议，请直接改用最通用、最稳定的 Chat Completions (/v1/chat/completions) 接口，两者的底层对话能力完全一致。

接口信息

项目	值
方法	POST
路径	/v1/responses
完整地址	https://api.gemai.cc/v1/responses
鉴权	Authorization: Bearer sk-你的令牌

请求体示例

{
  "model": "[官逆]gemini-2.5-pro",
  "input": "请用一句话解释什么是 API。"
}

代码示例

cURL

curl --location 'https://api.gemai.cc/v1/responses' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "[官逆]gemini-2.5-pro",
    "input": "请用一句话解释什么是 API。"
  }'

JavaScript

const response = await fetch('https://api.gemai.cc/v1/responses', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: '[官逆]gemini-2.5-pro',
    input: '请用一句话解释什么是 API。',
  }),
})

console.log(await response.json())

Python

import os
import requests

response = requests.post(
    'https://api.gemai.cc/v1/responses',
    headers={
        'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}",
        'Content-Type': 'application/json',
    },
    json={
        'model': '[官逆]gemini-2.5-pro',
        'input': '请用一句话解释什么是 API。',
    },
    timeout=120,
)

response.raise_for_status()
print(response.json())

返回示例

{
  "id": "resp_xxx",
  "object": "response",
  "model": "[官逆]gemini-2.5-pro",
  "output_text": "API 是让不同程序按照约定互相调用能力的接口。"
}

注意事项

• 如果客户端不支持 Responses 格式，优先使用 Chat Completions。
• 多模态、工具调用等高级字段请以客户端实际支持为准。