TokenPostie 最终用户文档

快速开始

AI 摘要

接入 TokenPostie 的最小流程是：登录客户控制台，确认实名状态，创建或选择 API Key，调用 GET /v1/models 获取可用模型，再调用目标能力接口。不要把 API Key 写入日志、工单或提示词。

当前稳定公开范围见 v1 稳定入口。需要复制客户端代码时，直接使用 SDK 示例。

1. 确认 API Base URL

首期测试环境的 API Base URL：

{PUBLIC_BASE_URL}

所有公开 API 都在这个 Base URL 后拼接 /v1/... 路径，例如：

{PUBLIC_BASE_URL}/v1/models
{PUBLIC_BASE_URL}/v1/chat/completions
{PUBLIC_BASE_URL}/v1/responses
{PUBLIC_BASE_URL}/v1/messages

客户自助入口在 /console，用于查看本 API Key 可见的模型授权、请求日志和账单摘要。/portal 仅作为旧版兼容入口保留。

{PUBLIC_BASE_URL}/console

2. 登录客户控制台

打开客户控制台：

{PUBLIC_BASE_URL}/console

首期账号通常由企业管理员或 TokenPostie 运营人员开通。登录后先确认：

  • 当前租户名称是否正确。
  • 当前成员是否有项目或 API Key 管理权限。
  • 实名认证是否已经通过。未实名时，API Key 创建、轮换或正式调用可能被限制。

后续 TokenPostie 会预留手机号、微信、支付宝等登录方式；正式开放前，以控制台内显示的账号方式为准。

3. 创建或选择 API Key

在客户控制台进入 API Key 页面：

  1. 选择目标项目。
  2. 创建 API Key，并填写用途名称。
  3. 确认允许调用的模型范围。
  4. 保存后只复制一次完整 API Key。

如果已经有 API Key，也可以直接选择已有 Key 进行在线体验或 API 调用。

TokenPostie 使用 Bearer 鉴权：

Authorization: Bearer tp_your_api_key

tp_your_api_key 是占位符。正式调用时替换为你自己的 TokenPostie API Key。

4. 获取可用模型

curl "{PUBLIC_BASE_URL}/v1/models" \
  -H "Authorization: Bearer tp_your_api_key"

返回中的 data[].id 才是当前 API Key 可以调用的模型名。

如果你使用 AI 编程助手协助接入，可以让它读取客户登录态下的只读上下文：

GET {PUBLIC_BASE_URL}/console/api/agent-context

该接口只返回脱敏 API Key 摘要、可用模型、文档入口、错误码入口和最近请求日志摘要。它不会返回完整 API Key、供应商密钥、上游原始日志、用户输入正文或模型输出正文。真实 API Key 仍应保存在你的服务端环境变量里，不要粘贴给 AI Agent。

5. 发起 Chat 请求

把上一步返回的模型 id 填入 model：

curl -X POST "{PUBLIC_BASE_URL}/v1/chat/completions" \
  -H "Authorization: Bearer tp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "model_from_models_api",
    "messages": [
      { "role": "user", "content": "请用一句话介绍 TokenPostie" }
    ]
  }'

6. 流式请求

curl -N -X POST "{PUBLIC_BASE_URL}/v1/chat/completions" \
  -H "Authorization: Bearer tp_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "model_from_models_api",
    "stream": true,
    "messages": [
      { "role": "user", "content": "请流式输出三条接入建议" }
    ]
  }'

7. Anthropic Messages 请求

如果你的客户端已经按 Anthropic Messages 协议接入，可以调用：

curl -X POST "{PUBLIC_BASE_URL}/v1/messages" \
  -H "x-api-key: tp_your_api_key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "model_from_models_api",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          { "type": "text", "text": "请用一句话介绍 TokenPostie" }
        ]
      }
    ]
  }'

Messages V1 首期只支持非流式纯文本请求，计费、余额、限额和请求日志与 Chat Completions 共用同一套口径。

下一步