生成视频 API

本文档描述 maasapi.casdao.com 的视频生成接口，视频部分上游对接 art-api.3dhaoxuan.com（Doubao Seedance 系列模型）。

接口路径

地址：https://maasapi.casdao.com/v1/video/generations

请求方式

POST 方式，请求参数为 JSON 格式

输入说明

请求头

请求头	说明
Authorization	Bearer token

请求体

字段	类型	必填	说明
model	string	是	模型 ID，如 doubao-seedance-2-0-fast-260128
prompt	string	是	文本提示词，描述期望生成的视频。中文建议 ≤500 字，英文建议 ≤1000 词
metadata	object	否	视频生成参数（分辨率、宽高比、时长等），见下表

metadata 参数说明

字段	类型	默认值	说明
generate_audio	boolean	true	true 生成有声视频（与画面同步的声音），false 生成无声视频
ratio	string	adaptive	生成视频宽高比：16:9、4:3、1:1、3:4、9:16、21:9、adaptive（根据输入自动选择最合适的宽高比）
duration	integer	5	视频时长（秒，整数）。Seedance 2.0 系列：[4, 15] s，也可设置为 -1 由模型自主选择时长（实际时长通过查询接口的 duration 字段获取，与计费相关）
resolution	string	720p	视频分辨率：480p、720p、1080p（Seedance 2.0 Fast、2.0 Mini 不支持）、4k（仅 Seedance 2.0 支持）
watermark	boolean	false	true 时视频右下角展示 AI 生成 水印
return_last_frame	boolean	false	true 时返回生成视频的尾帧图像（png，无水印），可通过查询接口的 content.last_frame_url 获取，便于实现连续视频生成

请求示例

curl -X POST "https://maasapi.casdao.com/v1/video/generations" \
  -H "Authorization: Bearer <你的API Key>" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "doubao-seedance-2-0-fast-260128",
        "prompt": "全程参考图片1的主体、视频1的镜头运动，并使用音频1作为背景音乐，生成4秒连贯自然的视频。",
        "images": [
          "asset://asset-20260805103207-35llf"
        ],
        "video_urls": [
          "asset://asset-20260805103211-se5s7"
        ],
        "audio_urls": [
          "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
        ],
        "metadata": {
          "resolution": "480p",
          "generate_audio": true,
          "ratio": "16:9",
          "duration": 4,
          "watermark": false
        }
      }'

响应

字段	类型	说明
id	string	视频生成任务 ID（task_id）。创建视频生成任务为异步接口，获取 ID 后需通过查询视频 API 查询状态与结果

响应示例：

{
  "id": "your-task-id"
}