volcengine/doubao-seedance-2-5-pro
统一异步任务式视频生成服务:创建任务返回 task_id,轮询查询任务状态,成功后返回转存永久 CDN 链接。底层 MiniMax-H3 / metaso / 豆包 Seedance / 万相 wan3.0-video 按权重自动路由。查询支持单任务 GET /v1/videos/{task_id} 与批量 POST /v1/videos/status_batch(1-20 个 task_ids,一次返回各任务状态,轮询更省请求);对口型任务(/v1/videos/lip-sync)也共用这两个查询接口。
接口详情
POST
https://ai.codenews.cc/v1/videos/generations请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| prompt | string | 是 | - | 视频描述,最多 1500 字符(超出由网关截断) |
| model | string | 否 | - | 可强制指定底层模型:minimax/MiniMax-H3 / metaso/MiniMax-H3 / volcengine/doubao-seedance-2-5-pro / aliyun/wan3.0-video,不传则按权重随机路由 |
| resolution | string | 否 | - | 480P / 720P / 768P / 1080P / 2K,按引擎能力收敛,非法回退引擎默认值 |
| duration | number | 否 | 5 | 视频时长(秒,整数),按引擎范围 clamp |
| ratio | string | 否 | 16:9 | adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16;文生视频默认 16:9,图生视频固定 adaptive |
| image | string | 否 | - | 首帧图:公网 URL 或 data:image/*;base64,... |
| last_image | string | 否 | - | 尾帧图(需与 image 配对) |
| seed | number | 否 | - | 随机种子,用于结果复现 |
代码示例
请将 $API_KEY 替换为您在控制台申请的真实 API Key。
响应示例
错误码
| 状态码 | 说明 |
|---|---|
| 401 | API Key 无效或缺失 |
| 400 | 参数错误,如缺 prompt / 不支持的模型 / last_image 未配 image |
| 400 | 余额不足,请充值 |
| 400 | 内容命中敏感词 |
| 404 | 任务不存在或不属于当前 apikey |