常见问题

• Base URL 应该填什么？

OpenAI 兼容客户端填写 https://www.zltokens.com/v1。只有工具明确要求完整聊天接口地址时，才填写 https://www.zltokens.com/v1/chat/completions。不要漏掉 /v1。

• 如何获取 API Key？

服务开通后提供密钥，或在控制台的 API 密钥页面创建。API Key 列表会脱敏显示；登录后的所有者可在 API Key 页面按需查看完整 Key。仍应妥善保存，泄露后请立即轮换。

• 模型名填平台名还是上游名？

填写平台公开模型名，不一定是上游真实模型名。管理员做过模型重命名后，客户端必须同步使用重命名后的名称。

• 模型列表为空怎么办？

先确认已登录、账号有可用额度、模型已启用、渠道已绑定该模型、模型已完成定价，并且账号或 API Key 没有限制该模型。

• API 错误码与排障在哪里看？

状态码对应处理、流式失败、超时与联系支持所需资料，统一见 [API 错误码与排障](/zh/docs/api-errors-and-troubleshooting)。

• 提示模型未定价怎么办？

说明该公开模型名还没有可执行价格。平台会在未定价时阻止真实调用，避免无价扣费；请先联系管理员完成模型定价。

• 为什么消耗比预期高？

查看使用日志里的输入 token、输出 token、缓存 token、媒体 token、模型名和请求时间。编程客户端常会自动附带项目上下文、文件或图片。

• 图片或视频如何计费？

以管理员配置的模型定价为准。图片、音频和视频可按 token、按次、秒数、分辨率、质量档位或表达式规则计费。

• 客户专属价格和普通价格冲突时谁优先？

客户专属模型价格优先于全局模型定价。没有命中客户专属价格时，才使用普通模型定价和后续潮汐规则。

• 潮汐 Tokens 是什么？

潮汐 Tokens 是按模型和每日时间窗口生效的倍率规则。当前界面没有星期选择；启用的规则每天在该时段生效。未启用或未命中规则时不影响扣费。

• 发票在哪里处理？

客户可在钱包或发票入口提交与查看发票信息；管理员在后台审核、登记和处理。实际开票规则以订单、合同或双方约定为准。

• 排障或联系支持时要提供什么？

请按 [API 错误码与排障](/zh/docs/api-errors-and-troubleshooting) 的清单准备信息；不要发送完整 API Key、密码或不必要的业务数据。