API 参考

API 概览

了解派拓支持的 API 协议、请求地址和通用规则。

派拓在同一个网关上提供多种 API 协议。密钥所属分组决定可用的模型和路由策略,客户端则按对应协议发送请求。

协议与地址

协议Base URL常用端点
OpenAI Compatiblehttps://paytok.ai/v1/responses、/chat/completions、/models
Anthropic Messageshttps://paytok.ai/v1/messages
Gemini APIhttps://paytok.ai/v1beta/models、/models/{model}:generateContent

请求格式

  • 请求体通常为 JSON,并使用 Content-Type: application/json。
  • OpenAI 兼容协议使用 Authorization: Bearer <API_KEY>。
  • Anthropic 协议可使用 x-api-key: <API_KEY>,Claude Code 通过 ANTHROPIC_AUTH_TOKEN 设置。
  • Gemini 客户端通常从 GEMINI_API_KEY 读取密钥。

流式输出

支持该能力的模型可通过 Server-Sent Events 返回流式结果。在 OpenAI 兼容请求中设置:

{
  "model": "<MODEL_ID>",
  "input": "Hello",
  "stream": true
}

模型选择

模型 ID 以密钥所属分组的实际配置为准。调用前可通过控制台或下列请求查询:

Terminal
curl https://paytok.ai/v1/models \
  -H "Authorization: Bearer $PAYTOK_API_KEY"
请不要根据网络上的旧示例猜测模型 ID。上游模型和组内路由会变化,以当前密钥返回的模型列表为准。