QINQYN ROUTER · 使用帮助

常见问题

从首次接入到核对账单,优先解决日常使用中最常见的问题。

接入与密钥

如何在工具或 SDK 中配置 API?
  1. 由管理员开通账号并分配额度后,进入密匙页面创建 API Key。
  2. 打开该密钥的「接入配置」,复制 API Key、Base URL 和获授权的准确模型名称。
  3. 支持 OpenAI 兼容接口的工具,Base URL 通常填写 https://api.qinqyn.com/v1;以接入配置显示的地址为准。部分工具会自动添加 /v1,避免重复填写。

使用本平台密钥,不要填写上游供应商密钥。Gemini 等其他协议须按对应模型和工具说明设置,不能直接套用 OpenAI 的地址与参数。具体步骤见工具接入指南。

如何确认密钥能使用哪些模型?

「接入配置」中的模型列表按该密钥的实际权限读取,调用时复制完整模型标识。模型广场用于了解模型能力与参考价格;广场展示的模型不代表当前密钥全部可用。看不到所需模型时,先检查密钥限制,再联系管理员确认账户分组和模型授权。

API Key 泄露或需要更换时怎么办?

怀疑泄露时立即禁用该密钥,检查消费日志,再创建新密钥并更新应用。建议为不同应用和环境分别创建密钥,保存在服务端环境变量或密钥管理服务中,不要放进公开仓库或网页前端。

向支持人员反馈时提供 Key 的编号或名称即可,不要发送完整 API Key、密码或验证码。

余额与账单

如何申请或增加使用额度?

账号和额度由管理员统一创建与分配,目前不提供自助在线充值。如需增加额度,请联系管理员或 service@qinqyn.com。到账后,在钱包核对余额及额度变更记录。

API Key 的额度上限是使用限制,不是额外的钱包余额。合同 Token 的剩余量和有效期以对应合同记录为准。

在哪里查看 Token 用量和人民币扣费?

在看板 → 概览查看输入、输出及合计 Token,并比较各模型用量;可按时间筛选。普通用户只查看本人数据,管理员可按用户筛选,页面会标明统计范围。

在钱包通过「消费明细」核对实际扣费,通过「Key 账单」核对各密钥使用情况,通过「额度变更」查看管理员的增减额度记录。Token 图表按保留的消费日志汇总,已删除日志不计入;它与账户累计消费的统计口径可能不同。

消费进度和预计可用时长分别是什么意思?

消费进度按「累计已消费 ÷(累计已消费+当前余额)」计算,展示账户整体金额使用情况,不代表某次充值的进度,也不随 Token 图表的时间或用户筛选变化。管理员调整余额后,比例会相应变化。

预计可用时长按当前余额和近 24 小时消费估算,近期没有消费时无法估算。它不是额度有效期;密钥有效期和合同 Token 有效期请分别查看密匙和合同记录。

为什么 Token 数量不能直接换算成账单金额?

不同模型、输入输出、缓存及计费方式可能使用不同价格,账户分组也可能影响最终费用。图像或视频请求的计费维度以具体模型配置为准,不能一律按 Token 或固定单次价格计算。

模型广场提供参考信息,实际扣费以消费明细中的计费说明为准。对金额有疑问时,请提供请求 ID 和调用时间,便于逐条核对。

调用排查

出现 401、403 或模型不可用时,先检查什么?
  1. 确认使用本平台 API Key,复制时没有多余空格;OpenAI 兼容接口通常使用 Authorization: Bearer <API_KEY>。
  2. 检查密钥是否启用、是否过期,以及 IP、模型和额度限制。
  3. 核对 Base URL、协议和模型标识,确认账户余额充足。

仍然失败时,保留完整报错文字和请求 ID,联系管理员核对日志。

遇到 429、超时或 5xx 错误怎么办?

先查看错误详情,判断是并发/频率限制、额度问题还是上游服务错误。降低并发,对允许重试的请求采用带退避的有限重试;如果响应包含 Retry-After,遵循其等待时间。

超时不一定代表上游没有执行。视频等异步任务应先用已返回的任务 ID 查询状态,避免重复提交造成重复任务或费用。持续失败时,提供调用时间、模型、请求 ID 和脱敏报错。

异步生成任务一直未完成,如何处理?

保存提交接口返回的任务 ID,按对应模型文档查询状态,并检查任务日志中的结果或失败原因。不同模型的任务路径、状态和耗时不同,不使用统一的固定完成时长判断。

不要持续重新创建相同任务。超过该模型说明的等待范围,或状态长期不变时,将任务 ID、提交时间和模型名称交给管理员排查。

仍未解决?

请准备调用时间、模型名称、请求 ID(异步任务提供任务 ID)、使用工具及脱敏后的报错。不要发送完整密钥、密码或验证码。