开发者文档

OpenAI 兼容协议 · 流式输出 · 按 token 与按次计费 · 支持 Claude 原生协议

新功能 · Tune Studio 比起写代码更喜欢直接对话?Tune Studio 让你在浏览器里用上全部正版模型——会话自动保存,随时续聊。 查看指南

快速开始 · 从注册到第一个 token 只需 5 分钟

只改一行 base_url——现有 AI 应用零改造直接迁移

15 分钟

注册

企业邮箱 / 手机号注册,5 分钟内自动开通。

21 分钟

创建应用

挑选模型、设置额度,一键获取 API Key。

30 分钟

替换 base_url

将 SDK 指向 TuneRouter,即刻上线。

quickstart.py — Python / OpenAI SDK
from openai import OpenAI

client = OpenAI(
    api_key="sk-tr-your-token",
    base_url="https://api.tunerouter.com/v1"  # the only line you change
)

resp = client.chat.completions.create(
    model="auto",  # TuneRouter picks the best model; or pin one like glm-5.3 / claude-opus-4-8
    messages=[{"role": "user", "content": "Hello!"}]
)
print(resp.choices[0].message.content)
Cursor Dify LangChain OpenAI SDK Anthropic SDK ChatGPT-Next-Web
面向金融、政务等合规场景,提供内网私有化部署与专属网关地址

API 参考

接入、调试到正式上线所需的一切

01API 基础
Base URLhttps://api.tunerouter.com/v1
认证方式Authorization: Bearer sk-tr-your-token
接口列表POST /v1/chat/completions · POST /v1/messages(Claude 原生) · POST /v1/images/generations · GET /v1/models
流式输出支持——设置 "stream": true(SSE 透传)
02cURL
chat.sh — 流式请求
curl https://api.tunerouter.com/v1/chat/completions \
  -H "Authorization: Bearer sk-tr-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "stream": true,
    "messages": [{"role": "user", "content": "Hello, introduce yourself"}]
  }'
03Python(OpenAI SDK)
chat.py
from openai import OpenAI

client = OpenAI(
    api_key="sk-tr-your-token",
    base_url="https://api.tunerouter.com/v1"
)

resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "1+1=?"}]
)
print(resp.choices[0].message.content)
04Claude 原生协议(Anthropic SDK)

Anthropic 官方 SDK 直连——无需 OpenAI 转换层,支持流式输出与缓存感知计费。注意 base URL 不带 /v1 后缀,SDK 会自动补全。

claude.py
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-tr-your-token",
    base_url="https://api.tunerouter.com"
)

msg = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}]
)
print(msg.content[0].text)
05图像生成

按次计费的图像模型(glm-image / seedream / wan-image 等)通过 /v1/images/generations 调用。

image.sh
curl https://api.tunerouter.com/v1/images/generations \
  -H "Authorization: Bearer sk-tr-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-image",
    "prompt": "An orange cat wearing glasses, cartoon style"
  }'
06计费规则
07错误码
HTTP含义
401Token 无效或已禁用
402余额不足(预扣费校验未通过)
404模型不存在或无可用通道
4xx上游参数错误,原样透传(不计费)
502所有通道均失败(预扣费用已退还)

常见问题

关于计费、私有化部署与新模型的常见疑问

model="auto" 是什么意思?

auto 模式下,TuneRouter 按成本、时延与能力为每个请求匹配最优模型,并智能调优调用参数。你也可以在请求中显式指定模型(如 glm-5.3、claude-opus-4-8)。

计费如何结算?有最低消费吗?

纯按量计费:按模型输入 / 输出 token 计量,全线模型统一约为官方刊例价 85 折;按月合并出账,无最低消费、无隐形费用,按月或按季结算,用量大可洽谈阶梯返点。失败请求永不计费——详见上方错误码表。

支持私有化部署吗?

支持。TuneRouter 支持内网私有化部署与专属网关地址,提供多租户隔离、分级 API Key 与全量审计日志——满足金融、政务等场景的合规需求。

新模型上线有多快?供应商故障怎么办?

DeepSeek、Qwen、Claude、GPT 等主流厂商的新模型发布当天即可调用,72 小时内保障上线。若供应商超时或出错,请求会自动重试下一个最优模型——业务完全无感,无需人工救火。

准备好接入了?

联系客户经理 → 开通租户 → 获取 API Key → 正式上线

联系我们的团队
mail@TuneRouter.com