TokenPorts
DEVELOPER DOCS

统一 API 接入

平台密钥以 mp_live_ 开头。正式模型未开启前，所有模型调用都会返回明确的不可用错误且不会计费。

快速开始

在控制台创建密钥，然后把请求发送到你的 TokenPorts 域名。

curl https://your-domain.com/v1/chat/completions \
  -H "Authorization: Bearer mp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai-general",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

身份认证

把平台密钥放在 Authorization: Bearer ... 请求头。密钥只在创建时完整显示一次；服务端仅保存 SHA-256 摘要。

兼容端点

GET /v1/models列出当前已启用模型
POST /v1/chat/completionsOpenAI 兼容聊天入口
POST /v1/responsesOpenAI Responses 预留入口
POST /v1/messagesAnthropic Messages 兼容入口

错误与请求追踪

OpenAI 兼容端点返回 error.message/type/code；Messages 端点返回 Anthropic 风格的 type: error。每个响应都包含 x-request-id，可用于工单排查。

限流与计费

限流按“API Key + 模型 + 分钟”计算，并返回剩余额度请求头。调用启用后，系统先预留余额，以上游返回的实际 Token 用量结算；失败请求释放预留，不收取模型费用。