OpenAI Responses

第 1 版 · 更新于 2026-11-12 · 阅读约 1 分钟

通过 Runtoken 调用 Responses 接口。

准备工作#

开始前，请准备：

• 在控制台创建的平台 API Key。
• 支持 OpenAI Responses 的准确模型 ID。
• 可发送 HTTP 请求的服务端环境，本页示例使用 curl。

接口与鉴权#

通过以下接口发送 JSON，在请求头中携带 Authorization: Bearer YOUR_PLATFORM_KEY。

OpenAI SDK 的 base URL 为 https://api.runtoken.net/v1。

发送请求#

下面的示例提交一段文本，并请求流式输出。

curl -N 'https://api.runtoken.net/v1/responses' \
  -H 'Authorization: Bearer YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "Hello!",
    "stream": true
  }'

运行示例前，请替换以下占位值。

curl -N 会关闭输出缓冲，便于及时查看流式数据。

管理对话上下文#

由应用保留所需的上下文，并随每次请求提交。不要依赖响应 ID 恢复上一轮对话。

压缩上下文#

独立的 Compact 接口使用输入数组提交请求。

curl 'https://api.runtoken.net/v1/responses/compact' \
  -H 'Authorization: Bearer YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": [{ "role": "user", "content": "Hello!" }]
  }'

运行示例前，请替换以下占位值。

此请求仅用于支持 Compact 的模型，支持 Responses 不代表同时支持 Compact。

参数与流式输出#

在请求中使用工具、结构化输出或多模态输入之前，需要确认所选模型的支持情况。

开始输出后，平台不会再切换通道。流式连接中断时，应保留部分结果，将重试作为新请求处理；相关用量可能需要计费复核。

下一步#

使用消息列表发送对话，可阅读 OpenAI Chat；通用的路由与计费规则见接入指南。