常见问题
接入相关
Q: 我已经在用 OpenAI 官方 SDK，迁移到本平台需要改多少代码？
A: 只需修改两个参数：
# 改前（OpenAI 官方）
client = OpenAI(api_key="sk-...")
# 改后（iDreame）
client = OpenAI(
base_url="https://api.idreame.com/v1",
api_key="sk-xxxxxxxx", # 换成本平台的令牌
)其余代码完全不需要修改。
Q: 支持哪些编程语言的 SDK？
A: 所有与 OpenAI 兼容的 SDK 均可使用，包括但不限于：
- Python：
openai、langchain、llama-index - JavaScript/TypeScript：
openai、ai（Vercel AI SDK） - Go：
go-openai - Java：
openai-java - Rust：
async-openai
任何支持自定义 base_url 的 HTTP 客户端或框架均可直接接入。
Q: 如何在 ChatGPT 客户端（如 ChatBox、Open WebUI）中使用？
A: 在客户端设置中找到「API 地址」或「Base URL」选项，填入 https://api.idreame.com/v1，并填入你的令牌即可。
Q: 本平台的 API 地址和 OpenAI 官方有什么区别？
A: 只是 Base URL 不同，接口路径、参数格式、响应结构与 OpenAI 官方完全一致。你可以把本平台理解为 OpenAI 的「国内优化代理 + 多模型聚合网关」。
令牌与权限
Q: 一个账号可以创建多少个令牌？
A: 目前无限制，建议为不同项目创建独立的令牌以便管理。
Q: 令牌可以设置哪些权限？
A: 可配置：
- 额度上限：该令牌累计可消费的最大额度
- 过期时间：令牌自动失效的日期
- 模型分组：限制该令牌只能调用特定的模型
- IP 白名单：只允许特定 IP 地址使用
Q: 令牌泄露了怎么办？
A: 立即登录控制台，在「令牌管理」中删除泄露的令牌，然后重建一个新令牌。旧令牌删除后立即失效，之前的泄露不会产生额外消费。
计费相关
Q: 计费是按请求次数还是 Token 数量？
A: 按实际消耗的 Token 数量计费，不按请求次数。发送一条很短的消息，消耗的 Token 就少，对应费用也少。
Q: 我的余额在哪里查看？
A: 登录控制台后，顶部状态栏实时显示余额。详细的消费记录在「用量统计」页面。
Q: 如何知道每次 API 调用消耗了多少 Token？
A: 每次非流式请求的响应中都包含 usage 字段：
"usage": {
"prompt_tokens": 28,
"completion_tokens": 120,
"total_tokens": 148
}流式请求可以设置 stream_options: {"include_usage": true} 在最后一个数据块中获取用量。
错误排查
Q: 收到 401 错误怎么处理？
A: 检查以下几点：
- 请求头格式是否正确：
Authorization: Bearer sk-xxxxxxxx - 令牌是否存在（在控制台「令牌管理」确认）
- 令牌是否已被删除或禁用
Q: 收到 403 错误怎么处理？
A: 可能是以下原因：
- 账户余额不足，请充值
- 令牌的额度限制已达上限
- 你请求的模型不在令牌的可用分组内
- 你的请求 IP 不在令牌的 IP 白名单内
Q: 收到 429 错误怎么处理？
A: 触发了速率限制，建议：
- 降低并发请求数量
- 在请求之间添加适当延迟
- 使用指数退避重试策略（详见错误码文档）
Q: 某个模型一直返回 503 怎么办？
A: 可能是该模型的上游渠道暂时不可用。建议：
- 等待几分钟后重试
- 切换到功能相近的其他模型
- 在控制台查看服务状态公告
其他
Q: 数据会被用于模型训练吗？
A: 不会。平台不会使用用户的请求数据训练模型，具体见隐私政策。
Q: 如何联系客服？
A: 可通过以下方式联系：
- 控制台内「工单系统」提交问题
- 邮箱：support@idreame.com
- 微信公众号：iDreame算力平台