常见问题
通用问题
Puyun AI 和直接调用 OpenAI/Claude API 有什么区别？
Puyun AI 是一个 AI API 聚合网关。通过 Puyun AI，你可以：
- 用一个 API Key 访问 40+ 供应商的所有模型
- 自动协议转换，无需为不同模型适配不同 SDK
- 享受智能路由、故障转移和负载均衡
- 统一的计费和管理面板
直接调用每个供应商需要分别注册账号、管理多个 API Key、适配不同协议。
协议自动转换是怎么工作的？
当你通过 OpenAI 协议调用 Claude 模型时，Puyun AI 会：
- 接收 OpenAI 格式的请求
- 将其转换为 Anthropic 原生格式发送给上游
- 将 Anthropic 原生响应转换为 OpenAI 格式返回给你
反向同理——通过 Anthropic 协议调用 OpenAI 模型也会自动转换。整个过程对客户端完全透明。
支持哪些模型？
支持 OpenAI、Anthropic、Google、AWS Bedrock、Azure、DeepSeek、Mistral、Meta 等 40+ 供应商的模型。完整模型列表请查看首页，或通过 GET /v1/models 接口查询。
账户与计费
三个服务层级有什么区别？
| 层级 | 定位 | 稳定性 | 价格 |
|---|
| Test | 测试验证 | 基础 | 最低 |
| Flex | 个人开发 | 良好 | 中等 |
| Enterprise | 企业生产 | 最高 | 较高 |
详细对比请参考使用方式页面。
如何充值？
登录 Portal，在账户页面选择充值金额。支持预付费模式，Token 消耗从余额中实时扣除。
余额不足会怎样？
当余额耗尽时，API 请求将返回 429 Too Many Requests 错误。请及时充值以恢复服务。
如何查看用量？
登录 Portal，在用量页面可以查看按日期、模型维度的 Token 消耗和费用明细。
连接与配置
API Base URL 是什么？
- OpenAI 协议：https://ai.tracup.com/v1
- Anthropic 协议：https://ai.tracup.com
- Gemini 协议：https://ai.tracup.com
为什么 OpenAI 协议的 Base URL 有 /v1 而 Anthropic 没有？
这是各协议的惯例：
- OpenAI SDK 默认在 base URL 后拼接 /chat/completions 等路径，所以 base URL 需要包含 /v1
- Anthropic SDK 默认在 base URL 后拼接 /v1/messages，所以 base URL 不应包含 /v1
支持流式响应吗？
支持。所有协议的端点都支持流式输出，设置 stream: true 即可。
模型与功能
可以通过 Anthropic 协议调用 OpenAI 模型吗？
可以。Puyun AI 的协议自动转换功能支持跨协议调用任意模型。通过 Anthropic 协议调用 GPT-4o 时，请求和响应会自动适配。
Function Calling 支持吗？
支持。Function Calling / Tool Use 在协议转换中会被正确映射。
支持图片输入吗？
支持。OpenAI、Anthropic、Gemini 协议均支持图片输入（Vision），具体格式请参考各协议的 API 参考文档。
Extended Thinking 支持吗？
Extended Thinking 是 Claude 模型的特有功能，仅在 Anthropic 协议下调用 Claude 模型时可用。通过协议转换调用非 Claude 模型时不支持此功能。
错误排查
返回 401 错误
- 检查 API Key 是否正确
- 确认 Header 格式：Authorization: Bearer sk-xxx 或 x-api-key: sk-xxx
- 确认 API Key 未过期
返回 429 错误
- 余额不足：在 Portal 中充值
- 速率限制：等待一段时间后重试，或升级到更高的服务层级
返回 404 错误
- 检查请求路径是否正确
- 确认模型名称拼写正确
- 确认 Base URL 配置正确（OpenAI 协议需包含 /v1）
响应格式异常
- 确认你使用的协议端点与客户端匹配
- 检查模型是否支持你使用的功能
- 尝试用 curl 直接请求验证
连接超时
- 检查网络是否能访问 ai.tracup.com
- 确认 Base URL 拼写正确
- 如果使用代理，检查代理配置