OpenAI Chat

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

通过 Runtoken 调用 Chat Completions 接口。

准备工作#

发送请求前，请准备：

• 在控制台创建的 Runtoken 平台 API Key。
• 模型目录中支持 OpenAI Chat 的准确模型 ID。
• 可安全保存 Key 并发送 HTTP 请求的服务端运行环境；本页示例使用 curl。

接口与鉴权#

向网关发送 JSON 请求，并在 Authorization 请求头中携带平台 Key。

使用 OpenAI SDK 时，将 base_url 设为 https://api.runtoken.net/v1；直接发送 HTTP 请求时，使用下方完整的接口地址。

发送请求#

下面的示例发送一条用户消息，并请求流式输出。

curl -N 'https://api.runtoken.net/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{ "role": "user", "content": "Hello!" }],
    "stream": true
  }'

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

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

继续对话#

由应用保存对话历史，并在下一次请求中提交需要的消息。Runtoken 的推理是无状态的，后一次请求不会自动继承前一次对话。

网关不会转换协议。使用 Anthropic Messages 或 Gemini v1beta 的模型，应通过各自的原生接口调用。

参数与模型能力#

图像输入、工具调用和结构化输出是否可用，取决于所选模型及其支持的请求格式。本页的文本示例不表示这些能力均已支持。

流式输出与重试#

平台可以在开始输出前自动切换通道；开始输出后，请求会保持在原通道。如果流式连接中断，应保留已收到的内容，由应用决定是否重新请求；中断的请求可能进入计费复核。

重试会发起一次独立请求。不要在用户不知情的情况下，将重复生成的内容拼接成原回答的后续部分。

下一步#

需要另一种请求格式时，可阅读 OpenAI Responses。通用的路由、计费和错误说明见接入指南。