API 文档
一个 Key 中转全球主流 AI 模型。OpenAI 兼容接口,按量计费,多通道容灾。
# 01 · 快速开始
▸ 四步拿到你的 API Key
在控制台注册账号,领取注册赠送的体验额度,创建 API Key,发起第一次请求。全程不到两分钟。
- 步骤 1.打开控制台注册账号(注册即送 $0.5 体验额度,实时到账)。
- 步骤 2.用兑换码充值,或先用赠送额度体验。
- 步骤 3.在面板点击 + NEW KEY 创建密钥,复制保存 sk-... 开头的 Key。
- 步骤 4.用下方示例发起第一次调用。完成。
# 02 · 认证
▸ Bearer 令牌
每个请求都必须在 Authorization 头中携带你的 API Key。Key 只在创建时完整显示一次,请妥善保存。
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
▸ 接口地址
https://api.taran-ai.com
# 03 · 对话补全
▸ OpenAI 兼容接口
POST /v1/chat/completions —— 兼容任何 OpenAI SDK,只需替换 base_url 和模型名。
curl https://api.taran-ai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TARAN_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": "你是一个乐于助人的助手。"},
{"role": "user", "content": "你好!"}
],
"stream": true
}'▸ Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.taran-ai.com/v1",
api_key="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
resp = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好!"}],
)
print(resp.choices[0].message.content)▸ Node.js
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.taran-ai.com/v1',
apiKey: process.env.TARAN_API_KEY,
});
const chat = await client.chat.completions.create({
model: 'deepseek-chat',
messages: [{ role: 'user', content: '你好!' }],
});
console.log(chat.choices[0].message.content);▸ 流式输出(SSE)
设置 "stream": true 即返回 Server-Sent Events 流,每个分片为标准的 OpenAI delta,以 data: [DONE] 结束。
# 04 · 模型与定价
▸ 可用模型
| 模型 | 类型 | 输入 | 输出 |
|---|---|---|---|
| deepseek-chat | 通用对话 | $0.40 / 1M | $0.60 / 1M |
| deepseek-reasoner | 深度推理 | $0.40 / 1M | $0.60 / 1M |
更多上游模型持续接入中。控制台展示实时模型列表与可用状态。
# 05 · 计费规则
▸ 额度体系
余额以 quota 计量,$1 USD = 500,000 quota。每次请求按 token 用量 × 模型倍率扣费。
▸ 单次请求计费公式
费用 = (输入token × 模型倍率 + 输出token × 补全倍率) / 500000
示例:deepseek-chat 输入 1,000 token + 输出 500 token = (1000 × 0.20 + 500 × 0.30) / 500000 = 0.0007 quota,即 $0.0007。
▸ 充值
购买兑换码后在面板输入,余额实时到账。
# 06 · 错误码
| HTTP | 错误码 | 含义 |
|---|---|---|
| 401 | invalid_api_key | API Key 缺失或错误 |
| 402 | insufficient_quota | 余额不足,请充值 |
| 404 | model_not_found | 模型名不存在 |
| 429 | rate_limit_exceeded | 请求过快,请降速 |
| 500 | upstream_error | 上游故障(自动重试) |
| 503 | overloaded | 通道繁忙,稍后重试 |
错误响应遵循 OpenAI 格式:{ "error": { "message": ..., "type": ..., "code": ... } }。
# 07 · 限流与免费额度
▸ 注册赠送额度
每个新账号自动获得 $0.5 免费额度。终端体验区向游客开放共享免费池——注册后拥有自己的独立余额。
▸ 公平使用
游客体验请求单次限制:输出 300 token、输入 2,000 字符。
# 08 · 常见问题
▸ 可以直接用现有的 OpenAI SDK 吗?
可以。把 base_url 改成 https://api.taran-ai.com/v1、模型名换成我们的模型即可,其余代码零改动。
▸ 我的 Key 安全吗?
Key 只在创建时完整显示一次。你与中转站之间的流量全程 TLS 加密。
▸ 上游服务商故障时怎么办?
中转站会在冗余通道上自动重试,请求不中断。
▸ 如何获得更多额度?
购买兑换码,在控制台面板兑换。
