快速结论
- suno 在单页中覆盖 Text-to-Video、Image-to-Video、R2V、Video Edit 四种流程。
- 页面支持参数对比与最小请求样例，便于快速验证和接口对接。
- 建议先在本页收敛参数，再迁移到生产 API。
关键参数
- model | string | 必填 | suno | - | 模型标识，固定使用 `suno`。
- prompt | string | 必填 | - | - | 描述目标视频的主体、动作、场景与风格。
- aspect_ratio | string | 可选 | 16:9 | 16:9 | 9:16 | 1:1 | 视频画幅比例，默认 `16:9`；支持 `16:9 | 9:16 | 1:1`。
- duration | integer | 可选 | 6 | 5 | 10 | 15 | 20 | 输出时长，单位秒；默认 `6`，支持 `5 | 10 | 15 | 20`。
- resolution | string | 可选 | 720P | 720P | 输出分辨率；默认 `720P`，支持 `720P`。
常见错误
- 400 invalid_request_error: 触发=请求体缺少必填字段或字段类型不匹配。; 修复=校验 model、mode、input 的字段完整性与类型。; 重试=修正参数后重试，不建议直接盲重试。
- 401 authentication_error: 触发=缺少 Authorization 头或 API Key 无效。; 修复=确认 Bearer Token 与密钥权限范围。; 重试=修复鉴权后重试；连续失败请轮换密钥。
- 429 rate_limit_exceeded: 触发=请求频率、并发或当前额度命中上游限流策略。; 修复=先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。; 重试=建议指数退避（例如 1s/2s/4s）+ 抖动；连续触发时再收紧提交节奏。
- 500 internal_error: 触发=上游服务瞬时异常或内部处理失败。; 修复=记录 request id 并触发重试链路。; 重试=可短间隔重试 2-3 次，持续失败请升级人工排查。