API 调试
使用接口页的调试面板验证地址、认证、请求体与异步结果
每个接口参考页都带有请求构造器。调试时先选择实际服务地址，再填写 Bearer Token 和参数；Token 只用于当前请求，不应粘贴到共享截图中。
推荐调试顺序
1. 创建最小任务
先只提交 model 和 prompt。
2. 保存公开任务 ID
复制创建响应中的公开任务 ID，不要复制上游或日志中的内部 ID。
3. 查询任务
在对应协议的查询页粘贴任务 ID，确认状态能从排队推进到终态。
4. 验证结果
完成后检查结果 URL；OpenAI 协议可继续测试内容下载。
5. 逐项增加参数
最后再加入图片、视频、音频、画幅、时长和布尔参数，便于定位无效字段。
常见调试误区
| 现象 | 优先检查 |
|---|---|
401 | Token 是否完整，Bearer 后是否有一个空格 |
404 | Base URL 是否错误地重复了 /v1；任务 ID 是否来自同一服务 |
unsupported_field | 是否把某个参数放到了错误层级 |
invalid_resolution | 火山兼容接口仅接受 480p、720p、1080p，Fast 模型不支持 1080p |
invalid_content | metadata.content 是否为数组，媒体项是否使用 { "url": "..." } |
| 浏览器跨域失败 | 使用文档站内置代理调试，或在服务端直接调用 API |
不要在生产浏览器中直连
文档调试面板用于开发验证。正式应用应由你的服务端保管 Token 并调用视频 API。
最后更新于