文档

快速接入

把 base_url 指向 TokenPP，用平台 Key 就能调用全部已上架模型。请求体与官方协议一致，已有代码通常只需要改 base_url 和 Key 两处。

三步接入

从注册到拿到第一个响应，只需要建 Key、备余额、改 base_url。

创建平台 Key
登录后在控制台「API Key」页新建一把 Key。Key 形如 sk-tpp-…，只在创建时完整显示一次，请立刻保存到安全的位置；之后列表里只能看到前缀。
准备余额
平台按用量预付费，用充值或兑换码入账后余额立即可用。余额为 0 时请求返回 402。
把 base_url 指向平台
OpenAI 兼容客户端填平台地址加 /v1；Anthropic 兼容客户端（Claude Code、Anthropic SDK）填平台地址本身，SDK 会自己补 /v1/messages。控制台总览页的接入卡片会显示你当前部署的实际地址，可一键复制。

curl https://<platform-host>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-tpp-..." \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{ "role": "user", "content": "ping" }]
  }'

常见客户端

凡是支持自定义 base_url 的客户端都能接，下面是几个常见的填法。

OpenAI SDK

把 base_url 设为平台地址加 /v1，Key 用平台 Key。openai 的 Python / Node SDK 与官方 CLI 都适用。

Cursor

在 Settings → Models 里打开 OpenAI API Key，填入平台 Key，并把 Override OpenAI Base URL 设为平台地址加 /v1。

Claude Code

把 ANTHROPIC_BASE_URL 设为平台地址（不带 /v1），ANTHROPIC_AUTH_TOKEN 设为平台 Key。

自建应用

任何能改 base_url 与 Authorization 头的 HTTP 客户端都可以，请求体沿用 OpenAI 或 Anthropic 的官方格式。

协议端点

平台提供 OpenAI 与 Anthropic 两套兼容入口，鉴权方式相同：Authorization: Bearer <平台 Key>，Anthropic 客户端也支持 x-api-key 头。

端点	协议	说明
POST/v1/chat/completions	OpenAI	对话补全，支持 SSE 流式
POST/v1/responses	OpenAI	Responses 接口，支持 SSE 流式
POST/v1/messages	Anthropic	Messages 接口，支持 SSE 流式
GET/v1/models	OpenAI	列出在售模型及单价，只返回已配置价格的模型

流式与超时

三个对话端点都支持 SSE，长回答建议开启。

请求体设置 stream: true 后，响应为 text/event-stream，逐帧返回 data: {...}，最后以 data: [DONE] 结束。
流式内容按到达顺序逐帧返回，不做整体缓冲；连接中断时会随之关闭。
长时间收不到新数据（默认 90 秒）会判定超时并断开，客户端需要处理连接提前关闭的情况。

计费与用量

按接口返回的实际 token 用量结算，没有固定套餐。

单价按每 100 万 token 计价、以美元为单位，输入、输出与缓存读写分别定价，见模型价格页。
请求发出前会按 max_tokens（或 max_output_tokens）与输出单价预估并临时预扣，请求结束后按实际 usage 结算，多预扣的部分自动释放。
流式对话请求会自动补上 stream_options.include_usage，让最后一帧带回 usage，计费以该 usage 为准。
每笔调用都会写入用量日志，包含模型、token 分项、扣费金额、耗时与状态码，可在控制台用量页查询。
余额耗尽后请求返回 402。

错误码

网关错误沿用 OpenAI 的错误结构：error.message、error.type、error.code、error.param。

HTTP	code	含义
401	invalid_api_key	Key 缺失、无效或已被删除
401	key_disabled	该 Key 已被停用
401	key_expired	该 Key 已过期
403	account_disabled	账户已被停用
402	insufficient_balance	账户余额不足，无法完成预扣
402	insufficient_quota	该 Key 的剩余额度已用尽
400	invalid_body	请求体不是合法 JSON，或缺 model 字段
404	model_not_found	模型不存在或未上架
429	rate_limited	触发该 Key 的 RPM、TPM 或并发限制
503	upstream_unavailable	服务暂时不可用，请稍后重试

常见问题

base_url 到底该填什么？

OpenAI 兼容客户端填平台地址加 /v1；Anthropic 兼容客户端只填平台地址。控制台总览页可以直接复制当前部署的实际地址。

为什么提示模型不存在？

该模型没有上架，或没有配置价格。到模型价格页确认 slug 是否在售。

返回 401 该检查什么？

确认请求头是 Authorization: Bearer <平台 Key>，并且用的是平台 Key（sk-tpp- 开头）。Key 被停用或过期同样返回 401。

流式响应中途断了怎么办？

通常是连接中断或长时间无数据触发超时。客户端应处理连接提前关闭，必要时重试；已经产生的用量仍会正常计费并写入日志。

怎么知道每次调用扣了多少钱？

控制台用量页按请求列出 token 分项与扣费金额，可按模型和 Key 汇总。

返回首页