接入指南

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

通过模型原生协议接入 Runtoken。

准备工作#

开始前，请准备：

在控制台创建平台 API Key，并保存在服务端。
从模型目录复制准确模型 ID，确认它使用的原生协议。
准备可访问网关的 HTTP 客户端或 SDK 运行环境。

平台地址#

所有协议共用一个域名。需要 OpenAI 风格 base URL 的 SDK，填带 /v1 的地址。

网关https://api.runtoken.net

OpenAI SDK base_urlhttps://api.runtoken.net/v1

支持的协议#

协议	接口	Key 请求头
OpenAI Chat Completions	POST `/v1/chat/completions`	`Authorization: Bearer`
OpenAI Responses	POST `/v1/responses`	`Authorization: Bearer`
Responses Compact	POST `/v1/responses/compact`	`Authorization: Bearer`
Anthropic Messages	POST `/v1/messages`	`x-api-key · anthropic-version`
Gemini v1beta	POST `/v1beta/models/{model}:streamGenerateContent`	`x-goog-api-key`
向量嵌入	POST `/v1/embeddings`	`Authorization: Bearer`
图像生成	POST `/v1/images/generations`	`Authorization: Bearer`
图像编辑	POST `/v1/images/edits`	`Authorization: Bearer`
语音合成	POST `/v1/audio/speech`	`Authorization: Bearer`
语音转写	POST `/v1/audio/transcriptions`	`Authorization: Bearer`

原生异步视频任务使用单独的 API，按模型配置。

请求示例#

一个流式对话请求。选你的模型所用的协议。

bash

# 可选：用 -H 'Channel-Slug: your-channel-slug' 指定偏好通道
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 '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 'https://api.runtoken.net/v1/messages' \
  -H 'x-api-key: YOUR_PLATFORM_KEY' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "max_tokens": 1024,
    "messages": [{ "role": "user", "content": "Hello!" }],
    "stream": true
  }'

curl -N 'https://api.runtoken.net/v1beta/models/YOUR_MODEL_ID:streamGenerateContent?alt=sse' \
  -H 'x-goog-api-key: YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{ "parts": [{ "text": "Hello!" }] }]
  }'

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

示例占位值	替换为
`YOUR_PLATFORM_KEY`	在控制台创建的平台 API Key。
`YOUR_MODEL_ID`	模型目录中使用所选协议的模型 ID。

路由#

可以加一个 Channel-Slug 请求头来指定偏好通道，slug 在模型的价格详情里复制。

自动切换规则#

偏好通道不可用或出错时，请求会在开始输出之前回到平台的默认顺序。
一旦开始输出，请求不会再切换通道。
管理员固定的路由优先，且不会切换。

计费与用量#

每次调用平台都会向模型请求用量。中断的流式请求可能进入计费复核。
多媒体只按明确的用量计费。按次数、字符或时长计价的模型，token 单价为零。
转写时，如果模型支持，请用 verbose_json 拿到时长。

错误#

错误会返回 JSON，包含 type 和一句可读的 message。

200: 请求成功。
400: 请求体或参数无效。
401: Key 缺失、无效、过期或已吊销。
429: 触发了速率或花费限额。报错会写明是哪个限额、何时重置。
503: 服务暂时不可用，请退避后重试。

暂不支持#

下一步#

OpenAI Chat

发送消息并处理流式输出。

OpenAI Responses

提交输入，在不依赖已保存响应 ID 的情况下管理上下文。

Anthropic Messages

使用 Messages 原生接口及版本请求头。

Gemini v1beta

在 URL 中指定模型 ID，构造原生流式请求。

这篇文档有帮助吗？