帮助与支持
支持中心
常见问题解答、快速接入指南、错误排查手册与技术支持
快速接入与服务支持
获取快速接入指引，或通过工单与邮件获得官方技术协助
快速接入指南
查看标准 Base URL 与 OpenAI SDK / Python / cURL 示例
查看代码示例
工单支持
提交工单描述您遇到的问题，可上传截图，工程师将尽快处理回复。
提交与查看工单
邮件支持
遇到复杂接口问题或商务合作，欢迎致信官方邮箱
support@ainfix.com
常见问题解答 (FAQ)
整理了开发者在接入和使用平台过程中最常遇到的问题
本平台完全兼容 OpenAI 官方 API 格式。您只需在任意支持 OpenAI 的客户端（如 NextChat, ChatBox, Cherry Studio, LangChain, Cursor, Dify 等）中，将请求地址修改为：
https://api.ainfix.com/v1
* 提示：API 密钥（Key）请在「控制台 - API 密钥」中创建并填入客户端的 API Key 栏位。
HTTP 常见错误码速查表
调用 API 遇到报错时，根据返回的 HTTP 状态码快速定位与修复问题
| 状态码 | 错误类型 / 含义 | 常见原因 | 排查与解决方案 |
|---|---|---|---|
| 400 | 请求参数或格式错误 Bad Request | JSON 格式损坏、缺少必填参数、模型名称不存在或上下文长度超出限制。 | 检查请求体 JSON 是否有效，核对模型名称是否在模型列表中，减少 prompt 长度。 |
| 401 | 身份认证失败 / 密钥无效 Unauthorized | 未提供 Authorization 请求头、API Key 拼写错误或该 Key 已过期/被禁用。 | 在控制台确认 API Key 状态，确保请求头包含 `Authorization: Bearer sk-xxxx`。 |
| 403 | 访问权限受限 Forbidden | 用户账户被禁用、请求 IP 不在 Key 的 IP 白名单中，或 Key 无权调用该特定模型。 | 检查 Token 的 IP 白名单设置及模型权限白名单，或联系客服排查账户状态。 |
| 429 | 额度耗尽 或 触发速率限制 Too Many Requests | 账户/Token 余额不足，或每分钟请求次数 (RPM) / 每分钟 Token 数 (TPM) 超出当前等级限制。 | 前往控制台钱包充值额度；若为高频并发请求，请在代码中增加自动重试延迟。 |
| 500 / 502 | 系统内部或上游渠道服务异常 Internal / Upstream Error | 上游官方提供商突发宕机或网络抖动，网关正在自动进行多渠道健康重试与故障转移。 | 平台自带自动多节点容灾，通常 1~2 秒后重试即可恢复；若持续报错请查看状态或提交工单。 |
| 504 | 上游生成响应超时 Gateway Timeout | 请求超长长文本生成或复杂多模态任务，上游模型响应耗时过长超出 HTTP 超时阈值。 | 建议在请求中开启 `stream: true` 流式传输避免长时间等待，或调大客户端 timeout 阈值。 |