ThriceGate三思网关控制台获取 API key

English

第一次调用

三个值、一个请求。已经在用 OpenAI SDK 的话,只改其中两个。

base_url
https://router.xiaojins.com/v1
api_key
你的 key,放在请求头 Authorization: Bearer <key>
model
deepseek-flash、deepseek-flash-three-pass(三思)
curl https://router.xiaojins.com/v1/chat/completions \
  -H "Authorization: Bearer $THRICEGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

获取 key

登录、充值,然后在控制台创建 key。完整 key 只显示一次;控制台里可以直接跑第一次调用。

打开控制台

三思

model 填 deepseek-flash-three-pass。reasoning_effort 可选 low、medium、high、max(缺省 high);max_tokens 缺省 65,536。难题可能要几分钟,客户端超时设长一点,或用流式。

curl https://router.xiaojins.com/v1/chat/completions \
  -H "Authorization: Bearer $THRICEGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash-three-pass",
    "reasoning_effort": "high",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

翻译

POST /v1/workflows/translate,带 text 与 target_language(20 种:en fr tr ja ko es de pt it ru ar vi th id ms hi nl pl zh-hans zh-hant)。同一模型跑三轮:直译、修订、终稿。按所选模型 token 价 × 2 计费,三轮全计。

curl https://router.xiaojins.com/v1/workflows/translate \
  -H "Authorization: Bearer $THRICEGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "答之前先想三遍。", "target_language": "en"}'

安全检测

POST /v1/workflows/guard,body 为 {"input": "..."}。返回四个布尔值;裁判没能完成时 allowed 为 false,且不收费。

curl https://router.xiaojins.com/v1/workflows/guard \
  -H "Authorization: Bearer $THRICEGATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": "text to check"}'

契约、限制与计费 →

在工具里用

工具怎么配
任何 OpenAI 兼容客户端把 Base URL 设成上面的值,填入 key,model 写 id。
OpenAI SDK(Python、Node)创建 client 时传 base_url / baseURL 与 api_key / apiKey,见上面的示例。
环境变量大多数基于 OpenAI SDK 的工具会读 OPENAI_BASE_URL 与 OPENAI_API_KEY。

错误码

状态含义怎么办
400请求有误,或 model 不在我们提供的范围对照 /zh/models 检查 model id
401没带 key 或 key 不存在带上 Authorization: Bearer <key>;新 key 几秒内生效
402余额不足以支付这次请求(code 为 insufficient_credits)。每次调用先按可能的最大花费(含 max_tokens 的回复上限)冻结,结束后按实际用量扣费充值,或把 max_tokens 调小
403这个 key 没有该端点的权限写信给我们,附 key 的后四位
429这个 key 触发了频率限制稍等再试
5xx上游模型出错或超时重试;实时场景用 deepseek-flash

计费

先充值后使用:充值进一个美元余额,每次调用从中扣除,按 $0.00001 向上取整。价格见定价页,表价即最终价格。

表价即最终价格:含税,充值不收手续费,没有平台费。

定价 →