OpenAI 兼容接口

一个端点，接入
多种 AI 模型

通过 BlueOcean Token Router 统一调用模型服务。本页提供从创建令牌到完成首次请求所需的核心配置与可复制示例。

BASE URLhttps://api.tkrouter.ai/v1

没有找到匹配内容，请尝试其他关键词。

快速开始

完成下面三个步骤，即可发送第一条模型请求。

STEP 01

选择模型

在主站模型广场查看可用模型，并复制准确的模型标识。

STEP 02

创建 API Key

进入控制台创建令牌，按需要设置分组、额度和过期时间。

STEP 03

发送请求

将 Base URL、API Key 与模型名称填写到应用或代码中。

Base URL 说明：大多数 OpenAI 兼容客户端应填写 https://api.tkrouter.ai/v1；如果工具会自动追加 /v1，则填写 https://api.tkrouter.ai。

鉴权方式

所有 API 请求应在 HTTP Header 中携带 Bearer Token。请勿把真实密钥提交到公开仓库或暴露在浏览器前端代码中。

HTTP Header

Authorization: Bearer sk-your-api-key
Content-Type: application/json

获取可用模型

推荐通过模型广场确认价格和能力，并通过接口获取当前令牌可访问的模型标识。

cURL

curl https://api.tkrouter.ai/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

Chat Completions

适用于聊天、文本生成和多数 OpenAI 兼容客户端。将示例中的模型标识替换为模型广场中的实际值。

POST /v1/chat/completions

curl https://api.tkrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "你好，请介绍一下你自己。"}
    ]
  }'

字段	类型	说明
`model`	string	模型广场展示的准确模型标识
`messages`	array	按顺序排列的对话消息
`stream`	boolean	是否启用流式响应
`temperature`	number	采样随机性；是否支持及范围取决于模型

Responses API

支持 Responses API 的模型可使用统一输入格式。模型能力与参数支持情况以模型详情为准。

POST /v1/responses

curl https://api.tkrouter.ai/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "input": "用三句话解释什么是 API 网关。"
  }'

流式输出

在请求体中设置 "stream": true。服务会通过 SSE 分段返回结果，客户端应持续读取事件直到结束标记。

stream 参数

{
  "model": "your-model-id",
  "messages": [{ "role": "user", "content": "你好" }],
  "stream": true
}

状态码与排错

状态码	常见原因	处理建议
`400`	参数或请求体格式错误	检查 JSON、模型名与必填字段
`401`	API Key 缺失或无效	检查 Authorization Header
`403`	令牌无权访问目标资源	检查分组、模型权限与令牌状态
`429`	请求频率或额度受限	降低并发、检查额度并采用指数退避
`5xx`	服务或上游暂时异常	记录请求时间和错误信息后重试

Claude Code

通过环境变量把 Claude Code 指向兼容端点。请使用支持 Claude 协议的模型与令牌分组。

macOS / Linux

export ANTHROPIC_BASE_URL="https://api.tkrouter.ai"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"

claude

注意：Claude Code 的环境变量及认证行为可能随版本变化。如客户端版本要求不同变量，请以该版本官方说明为准。

Cherry Studio

提供商类型

选择 OpenAI 或 OpenAI Compatible。

API 地址

https://api.tkrouter.ai/v1

API 密钥

填写控制台创建的 sk-... 令牌。

模型标识

从模型广场复制，保持字符完全一致。

Python / JavaScript SDK

Python

openai-python

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tkrouter.ai/v1",
)

response = client.chat.completions.create(
    model="your-model-id",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

JavaScript

openai-node

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-api-key",
  baseURL: "https://api.tkrouter.ai/v1",
});

const response = await client.chat.completions.create({
  model: "your-model-id",
  messages: [{ role: "user", content: "你好" }],
});
console.log(response.choices[0].message.content);

安全建议

只在服务端保存密钥

不要将 API Key 写入网页、客户端安装包或公开代码仓库。

最小化授权范围

为不同项目创建独立令牌，并设置合理额度和有效期。

定期轮换

发现异常调用或疑似泄露时立即禁用旧令牌并创建新令牌。

记录请求标识

排错时保存时间、状态码和响应错误，但不要在日志中打印完整密钥。

常见问题

Base URL 是否需要包含 /v1？

多数 SDK 和兼容客户端应使用 https://api.tkrouter.ai/v1。如果工具会自行追加 /v1，请填写不带版本路径的根地址。

为什么提示找不到模型？

请从模型广场复制模型标识，确认大小写和符号完全一致，并检查当前令牌所在分组是否具有访问权限。

为什么返回 401？

检查请求头是否为 Authorization: Bearer sk-...，并确认令牌未禁用、未过期且复制时没有多余空格。

生产环境应该如何重试？

只对超时、429 和部分 5xx 错误进行有限次数重试，采用指数退避并加入随机抖动。不要无限重试参数错误或鉴权错误。