接入文档
OpenAI 与 Anthropic 兼容
熊猫算力第一版 API 参考:OpenAI Chat Completions 与 Anthropic Messages 兼容接入。
熊猫算力的 API 参考先覆盖最常用的两类兼容入口:OpenAI Chat Completions 与 Anthropic Messages。完整 OpenAPI、更多协议 family 和在线调试器不在第一版文档范围内。
基础规则
| 协议 | Base URL 规则 | 典型路径 |
|---|---|---|
| OpenAI 兼容 | 客户端通常填写 {Base URL}/v1 | /v1/chat/completions |
| Anthropic Messages 兼容 | Claude Code 等客户端通常填写不带 /v1 的 {Base URL} | /v1/messages |
所有请求都使用 Bearer Token 鉴权。
OpenAI Chat Completions
OpenAI 兼容客户端通常只需要替换 base_url 和 api_key。
curl {API_BASE_URL}/v1/chat/completions \
-H "Authorization: Bearer {API_KEY}" \
-H "Content-Type: application/json" \
-d '{"model":"[在模型广场复制的模型 id]","messages":[{"role":"user","content":"Hello"}]}'Python 示例见 Python 示例。
Anthropic Messages
Claude Code 这类 Anthropic 兼容客户端使用 Messages 语义。注意 Base URL 配置字段通常不带 /v1,客户端会拼接 /v1/messages。
curl {API_BASE_URL}/v1/messages \
-H "Authorization: Bearer {API_KEY}" \
-H "Content-Type: application/json" \
-d '{"model":"[在模型广场复制的模型 id]","max_tokens":128,"messages":[{"role":"user","content":"Hello"}]}'兼容性边界
- 第一版文档只承诺兼容接入参考,不等同完整 OpenAPI。
- 模型专有字段是否生效,取决于模型和上游兼容能力。
- 请求能否成功还会受 API 密钥、模型白名单、API 分组、余额和服务可用性影响。
遇到错误时,先看 常见问题排查。