常见问题
从首次接入到核对账单,优先解决日常使用中最常见的问题。
接入与密钥
如何在工具或 SDK 中配置 API?
如何确认密钥能使用哪些模型?
「接入配置」中的模型列表按该密钥的实际权限读取,调用时复制完整模型标识。模型广场用于了解模型能力与参考价格;广场展示的模型不代表当前密钥全部可用。看不到所需模型时,先检查密钥限制,再联系管理员确认账户分组和模型授权。
API Key 泄露或需要更换时怎么办?
怀疑泄露时立即禁用该密钥,检查消费日志,再创建新密钥并更新应用。建议为不同应用和环境分别创建密钥,保存在服务端环境变量或密钥管理服务中,不要放进公开仓库或网页前端。
向支持人员反馈时提供 Key 的编号或名称即可,不要发送完整 API Key、密码或验证码。
余额与账单
如何申请或增加使用额度?
账号和额度由管理员统一创建与分配,目前不提供自助在线充值。如需增加额度,请联系管理员或 service@qinqyn.com。到账后,在钱包核对余额及额度变更记录。
API Key 的额度上限是使用限制,不是额外的钱包余额。合同 Token 的剩余量和有效期以对应合同记录为准。
在哪里查看 Token 用量和人民币扣费?
消费进度和预计可用时长分别是什么意思?
消费进度按「累计已消费 ÷(累计已消费+当前余额)」计算,展示账户整体金额使用情况,不代表某次充值的进度,也不随 Token 图表的时间或用户筛选变化。管理员调整余额后,比例会相应变化。
预计可用时长按当前余额和近 24 小时消费估算,近期没有消费时无法估算。它不是额度有效期;密钥有效期和合同 Token 有效期请分别查看密匙和合同记录。
为什么 Token 数量不能直接换算成账单金额?
不同模型、输入输出、缓存及计费方式可能使用不同价格,账户分组也可能影响最终费用。图像或视频请求的计费维度以具体模型配置为准,不能一律按 Token 或固定单次价格计算。
模型广场提供参考信息,实际扣费以消费明细中的计费说明为准。对金额有疑问时,请提供请求 ID 和调用时间,便于逐条核对。
调用排查
出现 401、403 或模型不可用时,先检查什么?
- 确认使用本平台 API Key,复制时没有多余空格;OpenAI 兼容接口通常使用
Authorization: Bearer <API_KEY>。 - 检查密钥是否启用、是否过期,以及 IP、模型和额度限制。
- 核对 Base URL、协议和模型标识,确认账户余额充足。
仍然失败时,保留完整报错文字和请求 ID,联系管理员核对日志。
遇到 429、超时或 5xx 错误怎么办?
先查看错误详情,判断是并发/频率限制、额度问题还是上游服务错误。降低并发,对允许重试的请求采用带退避的有限重试;如果响应包含 Retry-After,遵循其等待时间。
超时不一定代表上游没有执行。视频等异步任务应先用已返回的任务 ID 查询状态,避免重复提交造成重复任务或费用。持续失败时,提供调用时间、模型、请求 ID 和脱敏报错。
异步生成任务一直未完成,如何处理?
保存提交接口返回的任务 ID,按对应模型文档查询状态,并检查任务日志中的结果或失败原因。不同模型的任务路径、状态和耗时不同,不使用统一的固定完成时长判断。
不要持续重新创建相同任务。超过该模型说明的等待范围,或状态长期不变时,将任务 ID、提交时间和模型名称交给管理员排查。
仍未解决?
请准备调用时间、模型名称、请求 ID(异步任务提供任务 ID)、使用工具及脱敏后的报错。不要发送完整密钥、密码或验证码。