FAQ
常见问题
这里集中回答价格、接入、余额消耗和图片计费等常见问题。具体模型、分组倍率和可用接口以控制台展示为准。
第一次使用，我应该先做什么？
先注册并登录控制台，充值余额后创建 API Key。接入时把 Base URL 改成 https://api.zilan520.shop/v1，其余调用方式基本按 OpenAI 的习惯来。
能不能直接用 OpenAI 的 SDK？
可以。多数项目只需要替换 Base URL，并把 API Key 换成控制台生成的密钥。JavaScript、Python 和 cURL 示例可以在文档页查看。
为什么模型列表有时候拉不出来？
一般是密钥未填写、余额不足、网络拦截或当前线路临时波动。你可以先确认 API Key 是否正确，再在控制台看余额和可用模型；如果仍不正常，带上报错信息联系站点处理。
余额为什么按美元单位显示？
这是为了方便和模型官方价格、调用成本对应。当前价格页会给出人民币估算，实际余额变化请以控制台使用记录为准。
请求失败会不会扣费？
正常情况下，未成功产生可计费结果的请求不会按成功请求扣费。少数上游已经返回有效结果但下游主动中断的情况，以控制台使用记录为准。
生图没收到图片会不会扣费？
生图按“成功交付才计费”的方向处理：只有后端确认已经把最终图片结果成功写给用户，才进入图片计费；上游失败、无图片结果或连接中断不会按成功生图计费。
扣费看起来不对怎么办？
先在控制台打开使用记录，对照模型、分组、输入输出 token、图片数量和时间。如果仍然对不上，可以把使用记录截图或请求时间发给站点排查。
调用接口返回报错时先看哪里？
先看状态码和错误信息，再检查 API Key、余额、模型名称、请求格式和 Base URL。大多数接入问题都能从这几项里定位出来。
适合个人用，还是适合团队用？
个人开发、工作室和小团队都可以使用。个人更看重低成本试错，团队更适合用使用记录来追踪项目消耗和成员调用情况。
我已经有项目了，迁移麻烦吗？
如果项目本来就是 OpenAI-compatible 调用，迁移通常只需要改 Base URL 和 API Key。建议先用低并发、小流量测试，再逐步切换正式流量。