TARANPHASE
API RELAY
帮助中心TARAN PHASE // RELAY

API 文档

一个 Key 中转全球主流 AI 模型。OpenAI 兼容接口,按量计费,多通道容灾。

# 01 · 快速开始

▸ 四步拿到你的 API Key

在控制台注册账号,领取注册赠送的体验额度,创建 API Key,发起第一次请求。全程不到两分钟。

  1. 步骤 1.打开控制台注册账号(注册即送 $0.5 体验额度,实时到账)。
  2. 步骤 2.用兑换码充值,或先用赠送额度体验。
  3. 步骤 3.在面板点击 + NEW KEY 创建密钥,复制保存 sk-... 开头的 Key。
  4. 步骤 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错误码含义
401invalid_api_keyAPI Key 缺失或错误
402insufficient_quota余额不足,请充值
404model_not_found模型名不存在
429rate_limit_exceeded请求过快,请降速
500upstream_error上游故障(自动重试)
503overloaded通道繁忙,稍后重试

错误响应遵循 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 加密。

▸ 上游服务商故障时怎么办?

中转站会在冗余通道上自动重试,请求不中断。

▸ 如何获得更多额度?

购买兑换码,在控制台面板兑换。

← 返回首页