常见问题
接入前后最常被问到的十几件事。接口细节在接口速查,报错原因在错误码。
账号与充值
怎么注册账号?
在控制台点「注册」,填用户名和密码即可,注册完成后可自助登录。新账号余额为 0,调用前需要先充值。
怎么充值?
控制台「钱包」页输入兑换码,兑换成功后余额立即更新。目前没有接入在线支付通道, 充值走兑换码这一条路。
余额和消费在哪看?
顶栏一直显示当前余额;「首页」看今日与本月消费、调用次数和趋势;每一笔明细在 「消费记录」。
Key 与权限
怎么创建 API Key?
控制台「密钥」→ 新建,填名称;额度可以填具体数值,也可以勾「不限额度」; 模型权限选「全部模型」或「仅指定模型」,选后者时至少要挑一个模型。
为什么完整的 Key 只显示一次?
安全设计:页面离开后只保留前缀和状态,服务端按官方机制加密保存,不再回传明文。 如果没存下来,删掉这把重建一把即可,旧 Key 立即失效。
一个账号可以建几把 Key?
可以建多把,建议按项目或环境分开。每把能单独设额度和可用模型,某一把泄露时只删 那一把,不影响其他业务。
提示「额度耗尽」怎么办?
这是这把 Key 自己的额度用完了,不是账户余额不足。调高它的额度,或者新建一把; 账户余额不足时报的是 403,处理方式不同。
调用与报错
已有的 OpenAI 代码要改哪里?
只改两处:base_url 换成文档首页显示的网关地址(带
/v1), api_key 换成平台 Key。其余参数、SDK、调用方式都不用动。完整示例见快速开始。401、403、429、503 分别是什么意思?
401 是 Key 有问题(缺失、打错、已删除,或这把 Key 额度用完);403 是账户余额不足; 429 是被限流,隔一会儿再来;503 是模型不可用,多半是模型名不对或该模型暂时没有 可用渠道。逐条对照见错误码。
请求很久不返回,或者客户端超时?
长文本建议开流式输出(
stream: true), 首字节会明显更早到达;同时把客户端超时放宽到分钟级,别用默认的几十秒。提示上下文超长?
说明输入加输出的长度超过了该模型的上限。缩短输入,或在模型广场挑一个上下文更长的 模型——每张模型卡上都标了上下文长度。
计费与账单
按什么计费?
按 token 计费,输入和输出分开计价。部分模型分时段:工作日白天按高峰价,其余时间 按空闲价,按调用实际发生的时间段结算。缓存命中的输入按缓存价,比普通输入便宜。 单价以价格页为准。
被拒绝的请求会收费吗?
不会。认证失败、余额不足、模型不可用这类被拒绝的请求不产生费用。
在哪核对每一笔扣费?
「消费记录」逐条列出时间、模型、输入与输出 token、金额、请求状态和请求标识; 「用量统计」按天汇总,可以按模型和 Key 维度看。两边数字都来自后端账单,不是前端 自己算的。
价格以后会变吗?
价格页的数据实时取自后端,费用按调用发生时的价格结算,不会按新价格回头改旧账。 调整会记在更新记录里。