错误排查总览

调用失败时，先按现象定位，不必一开始就研究完整响应结构。

最常见问题

回到最小请求

使用快速开始的 curl 示例，只替换 API Key 和 model。

核对模型

在控制台模型广场复制完整模型 ID，不要手写后缀。

查看控制台日志

检查是否有扣费、上游错误、限流或任务失败记录。

再恢复业务参数

最小请求成功后，再逐个恢复 stream、图片、工具调用、特殊参数等。

检查 messages、model、stream、max_tokens。

检查 size、response_format、特殊参数和内容安全。

检查 task_id、轮询间隔、时长和素材 URL。

检查 multipart、文件大小、格式和超时。