API 常见问题

401：令牌无效

检查 Key 是否完整、是否被禁用，以及客户端是否把 Key 放在正确的认证字段中。

403：无权限或额度不足

检查账号和令牌额度，并确认令牌允许访问目标模型。

404：找不到模型或接口

使用模型广场中的完整模型 ID，并核对 Base URL 是否重复拼接 /v1。同时确认模型支持当前端点。

400：请求参数不支持

先用最小请求验证，再逐项恢复工具调用、多模态内容和推理参数。不同模型支持的字段可能不同。

文本成功，但图像或视频失败

图像、视频等能力不一定使用文本对话端点。查看模型详情，确认协议、端点、输入格式和任务参数。

如何报告问题

请提供发生时间、模型 ID、协议和端点、HTTP 状态码、脱敏后的错误正文和请求 ID。不要提交 API Key、上游凭据或完整隐私输入。