TokenPostie 最终用户文档

pageType: home title: TokenPostie 最终用户文档 description: 面向最终 API 用户和开发者的 TokenPostie API 接入文档。 context: 最终用户只需要理解公开 API、模型发现、鉴权、限额、计费、发票、请求日志和错误码；平台内部运营信息不在公开文档中暴露。 hero: name: TokenPostie 最终用户文档 text: 统一接入多模型 API tagline: 面向开发者的接入说明。先登录客户控制台，再发现模型、创建 API Key、发起 OpenAI 兼容请求，并按稳定错误码和明确账单口径处理业务。 actions: - text: 5 分钟快速开始 link: /quickstart theme: brand - text: 打开客户控制台 link: {PUBLIC_BASE_URL}/console theme: alt features:

  • icon: "01" title: 模型名不靠猜 details: 先调用 GET /v1/models 获取当前 API Key 可见模型，再把返回的 id 放入 Chat Completions 或 Anthropic Messages 请求体 model 字段。 link: /api/models
  • icon: "02" title: 客户控制台闭环 details: 在客户控制台查看实名状态、项目、API Key、模型授权、在线体验、请求日志、账单和发票信息。 link: /guides/customer-console
  • icon: "03" title: 账单口径清晰 details: 计费以 TokenPostie 记录的已确认用量、价格快照和账本为准，流式用量不完整时会进入复核。 link: /guides/billing-and-usage
  • icon: "04" title: 排障路径明确 details: 请求失败时先看请求 ID、错误码、模型授权、余额和限额，再按文档定位处理动作。 link: /guides/troubleshooting-and-security

推荐阅读顺序

  1. v1 稳定入口：确认当前公开 API、能力范围和不在短期范围的能力。
  2. 快速开始：完成第一条 Chat Completions 或 Anthropic Messages 请求。
  3. 账号与实名：确认账号、租户、成员权限和实名状态。
  4. 客户控制台：创建 API Key、选择模型、在线体验和查看请求日志。
  5. API Key 与限额：理解鉴权、余额、RPM、TPM、QPM。
  6. SDK 示例：复制 Chat、Embeddings、Rerank 和 Anthropic Messages 示例。
  7. 计费与用量：理解消费、账单和复核状态。
  8. 发票与付款：理解充值、后付费、发票信息和对账材料。
  9. 错误码：按稳定错误码做客户端处理。

常用入口

入口用途
{PUBLIC_BASE_URL}API Base URL，由环境变量 TOKENPOSTIE_PUBLIC_BASE_URL 配置
/console客户控制台，查看账号、实名、模型授权、请求日志、账单和发票信息
/docs/v1v1 稳定文档入口，确认当前公开能力范围
/docs/quickstart快速开始，完成第一条请求
/docs/guides/sdk-examplesSDK 示例，覆盖 Chat、Embeddings、Rerank 和 Anthropic Messages

最终用户文档边界

本文档只面向 TokenPostie 最终 API 用户和开发者。以下内容不会在最终用户文档中暴露：

  • 平台运营后台的内部配置、内部诊断证据和未公开模型验收材料。
  • 与客户排查无关的系统内部日志和维护信息。
  • 不属于客户租户、项目或 API Key 权限范围内的数据。