接入与配置
-
第一次使用，从哪里开始？
阅读5 分钟快速开始。 -
Base URL 应该填哪个？
不同客户端可能不同，请查看接入方式总览。 -
为什么出现 404？
404 通常是地址或接口路径错误。检查是否形成/v1/v1/...，以及客户端是否自动拼接请求路径；模型不可用更常表现为no available channel/503。 -
出现
status_code=500, not implemented？
若模型的supported_endpoint_types未包含当前请求所需协议，说明协议不兼容。请改用模型标明支持的接口，而不是原样重试；详见常见错误说明。 -
API Key 创建后不能使用？
检查 Key 状态、额度、分组、模型 ID 和Authorization: Bearer格式。
模型、分组与费用
-
怎么确认某个分组能否使用目标模型？
在模型广场按分组筛选并复制准确模型 ID。 -
一次请求消耗了多少？
在控制台使用日志中查看输入、输出、缓存和花费。字段说明见用量与日志说明。 -
失败请求是否扣费？
没有生成有效内容的错误记录通常为 0；存在中断或后续尝试时，需要按 Request ID 核对。 -
为什么余额正常却提示额度不足？
同时检查账号余额、API Key 额度和分组；持续出现时提交 Request ID。
调用错误
-
400、401、429、500、502、503、504、524 是什么？
查看API 调用常见问题。 -
长会话突然无法继续？
保存错误原文后，用新会话验证；为避免重复请求，请不要高频提交同一请求。 -
图片生成很慢或超时？
图片请求为同步请求。请先保存 Request ID，确认结果前避免重复提交同一任务，并查看图片模型使用说明。 -
错误后任务又成功了？
请以客户端是否收到完整内容和对应 Request ID 的最终记录判断。普通调用不承诺平台级自动重试；若客户端或程序再次提交，会产生新的 Request ID。
快速获得帮助
如果无法确定问题类型，按问题自查完成最小验证，并一次性提交：- Request ID
- 发生时间和时区
- 客户端及版本
- 模型和请求接口
- 完整错误原文
- 问题是偶发还是持续发生