API 参考
API 概览
了解派拓支持的 API 协议、请求地址和通用规则。
派拓在同一个网关上提供多种 API 协议。密钥所属分组决定可用的模型和路由策略,客户端则按对应协议发送请求。
协议与地址
| 协议 | Base URL | 常用端点 |
|---|---|---|
| OpenAI Compatible | https://paytok.ai/v1 | /responses、/chat/completions、/models |
| Anthropic Messages | https://paytok.ai | /v1/messages |
| Gemini API | https://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。上游模型和组内路由会变化,以当前密钥返回的模型列表为准。