主题
常见问题
接入相关
接入需要改多少代码？
几乎不用改。 我们完全兼容 OpenAI 协议，只需：
- 把 Base URL 改为
https://cn.guanqiintelligence.com/v1 - 把 API Key 换成本站密钥
业务代码无需改动。若使用其他协议，我们也支持 Claude 与 Gemini 协议，详见调用示例。
接口地址是什么？
生产接口：https://cn.guanqiintelligence.com/v1注意结尾是 /v1，配置时不要再加多余的斜杠。
model 应该填什么？
填模型列表里的模型 ID（如 doubao-seed-2.1-turbo）， 不是中文显示名称。填错会返回 404。
支持流式输出吗？
支持。请求中设 "stream": true 即可。我们已在网关侧关闭了响应缓冲，确保流式数据实时送达。
支持 Function Calling / 工具调用吗？
支持。绝大多数模型支持 OpenAI 格式的 tools 参数，具体以模型能力为准。
支持哪些客户端？
任何支持「自定义 OpenAI Base URL」的客户端都能直接接入，例如 Cherry Studio、LobeChat、ChatBox、Continue、Cline、沉浸式翻译等。
可以切换模型吗？切换成本高吗？
只需改 model 字段，不需要改任何其他代码。建议在测试环境先验证不同模型效果再切换。
账号与密钥
如何申请测试？
联系平台商务申请测试账号。我们会为你开通账号并发放固定额度的测试密钥， 测试期间所有模型均可正常调用，可完整验证接入效果。测试满意后签约转为正式账号。
测试密钥为什么过期了？
测试密钥默认有有效期限制（通常 30 天），到期自动失效。 如仍需测试或已签约，请联系平台商务重新发放或转为正式密钥。
可以把密钥写在前端代码里吗？
绝对不可以。 前端代码会被用户完整看到，密钥必然泄露，可能被人盗用产生费用。 正确做法是通过你自己的后端转发请求，密钥只存在于服务端。
密钥泄露了怎么办？
立即登录控制台吊销该密钥（即时生效），然后创建新密钥并更新服务配置， 再检查「使用日志」确认是否有异常调用。详见认证方式。
一个账号可以创建多少密钥？
没有硬性限制。建议按应用/环境分别创建，这样出问题时可以只吊销一个， 也能按密钥维度归因用量。
如何限制密钥的用途？
控制台支持为单个密钥设置：额度上限、有效期、可访问模型、IP 白名单。 生产环境建议至少配置额度上限和 IP 白名单。
计费与账单
怎么计费？
按实际用量的 token 数计费，输入与输出分别计价，部分模型按上下文长度分段计价。 详见计费说明。具体单价以合约为准。
在哪里看用量和账单？
登录控制台：
- 使用日志 —— 逐笔调用明细（时间、模型、token、金额），可筛选导出
- 钱包 —— 余额与账单历史
- 数据看板 —— 用量趋势统计
请求失败会扣费吗？
不会。 只有成功调用才计费。因参数错误、鉴权失败等原因被拒绝的请求不产生费用。
余额不足会怎样？
余额不足时调用会返回 insufficient user quota 错误。 建议在控制台设置额度提醒阈值，系统会在余额低于阈值时自动发邮件通知你。
可以开发票吗？
可以。请联系平台商务并提供开票信息（名称、纳税人识别号、地址电话、开户行及账号）。
如何降低费用？
- 简单任务用轻量模型（如
glm-5.3-flash），成本可低数倍 - 控制单次请求的上下文长度，避免触发高价档位
- 为密钥设置额度上限，防止异常超支
- 留意缓存命中的可能性（多轮对话、固定提示词）
稳定性与服务
接口可用性如何保障？
平台采用多通道容灾：上游请求失败自动重试；渠道异常自动摘除，恢复后重新纳管。 企业客户可约定 SLA 与专属通道。
请求报 5xx 怎么办？
我们已在上游失败时自动重试。若你仍收到 5xx，建议指数退避后重试 （如 1s、2s、4s…）。持续出现请提供 request_id 联系我们。
遇到限流怎么办？
返回 429 表示触发速率限制。建议降低并发，并配合指数退避重试。 如业务需要更高速率，请联系平台商务调整。
我的数据安全吗？
- 我们仅做请求转发，不存储你的对话内容与业务数据
- 传输全程 HTTPS 加密
- 上游凭证由平台统一托管，你的密钥与上游凭证隔离
还没解决？
请联系平台商务，并提供：
- request_id（错误信息里就有，能让我们直接定位那次调用）
- 使用的模型 ID
- 请求的时间与大致频率