OpenAI Responses 兼容

CokeAPI 已支持 OpenAI Responses API (/v1/responses)，适用于 OpenAI 兼容上游与部分扩展模型。

CokeAPI 已支持 POST /v1/responses。这条接口适合已经采用 OpenAI Responses API 的应用，或希望统一使用 input / output 结构的场景。

当前建议用于 gpt-4o-mini、部分扩展模型以及其他 OpenAI 兼容上游。Grok / Claude / Gemini 仍建议使用 Chat Completions。

调用示例

curl https://cokeapi.com/v1/responses \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "input": "用一句话介绍 CokeAPI"
  }'

curl -N https://cokeapi.com/v1/responses \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "输出一个 JSON，包含 title 和 summary",
    "stream": true
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://cokeapi.com/v1",
    api_key="sk-xxxxxxxx",
)

resp = client.responses.create(
    model="gpt-4o-mini",
    input="用一句话介绍 CokeAPI",
)

print(resp.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://cokeapi.com/v1",
  apiKey: process.env.COKEAPI_KEY,
});

const resp = await client.responses.create({
  model: "gpt-5.5",
  input: "总结一下 OpenAI Responses API 的适用场景",
});

console.log(resp.output_text);

请求参数

参数	类型	必填	默认值	说明
model	string	是	—	模型 ID。推荐使用 `gpt-4o-mini` 或扩展模型
input	string \| array	是	—	Responses API 标准输入
stream	bool	否	false	是否返回 SSE
instructions	string	否	—	顶层系统指令
tools	array	否	—	工具定义，透传 OpenAI 兼容上游
metadata	object	否	—	业务侧附加元数据
max_output_tokens	int	否	—	最大输出 token

请求体里必须包含 input；否则会返回 400 invalid_request_error: input is required。

响应示例

非流式

{
  "id": "resp_01HX...",
  "object": "response",
  "status": "completed",
  "model": "gpt-4o-mini",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "CokeAPI 是一个兼容 OpenAI 协议的多模型 AIGC 网关。"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 22,
    "total_tokens": 40
  }
}

流式

event: response.created
data: {"id":"resp_01HX...","object":"response","status":"in_progress","model":"gpt-5.5"}

event: response.output_text.delta
data: {"delta":"CokeAPI "}

event: response.output_text.delta
data: {"delta":"兼容 OpenAI Responses API。"}

event: response.completed
data: {"id":"resp_01HX...","status":"completed","usage":{"input_tokens":18,"output_tokens":22,"total_tokens":40}}

计费

仍按 token 计费。账单口径与 Chat Completions 一致，完整单价见模型列表。

注意事项

Responses 是透传模式，最终可用能力由当前上游决定。
返回中的 model 会被网关改写为你传入的对外模型 ID，而不是上游内部 ID。
如果你需要兼容 messages 结构、或要接 Grok / Claude / Gemini，优先用 POST /v1/chat/completions。
流式模式返回 SSE，客户端需要按事件流消费。

调用示例

请求参数

响应示例

非流式

流式

计费

注意事项

本页目录