Seedance 视频生成（Dreamina） - API Docs

AionRouter 支持 Dreamina 海外版模型。常见模型包括 dreamina-seedance-2-0-260128、dreamina-seedance-2-0-fast-260128、dreamina-seedance-2-0-mini-260615 和 dreamina-seedance-2-5-260628。未带版本号的 Dreamina 名称可以作为兼容别名。请以模型列表和你的权限为准。

请求头

Header	必填	说明
`Authorization`	是	`Bearer <API_KEY>`。
`Content-Type`	是	`application/json`。

请求体字段

字段	类型	必填	说明
`model`	string	是	Dreamina 模型 ID。
`prompt`	string	是	文本提示词。Router 会将它与参考内容一起提交。
`duration`	integer	否	Dreamina 2.0 系列为 4–15 秒，2.5 为 4–30 秒。
`seconds`	string	否	`duration` 的兼容字段；同时传入时值必须一致。
`images`	string[]	否	追加图片参考素材。不要与 `metadata.content` 同时使用；后者会作为完整参考内容提交。
`metadata`	object	否	传递 `content`、分辨率、画幅、帧数、随机种子和生成控制。

Dreamina 系列与限制

模型	可用时长	分辨率
`dreamina-seedance-2-0-260128`	4–15 秒	`480p`、`720p`、`1080p`、`4k`。带参考图时不支持 `1080p`。
`dreamina-seedance-2-0-fast-260128`	4–15 秒	`480p`、`720p`。
`dreamina-seedance-2-0-mini-260615`	4–15 秒	`480p`、`720p`。
`dreamina-seedance-2-5-260628`	4–30 秒	`480p`、`720p`。

未带日期的 dreamina-seedance-2-0、dreamina-seedance-2-0-fast、dreamina-seedance-2-0-mini 与 dreamina-seedance-2-5 是兼容别名。实际可用性仍以列出模型为准。

最小请求

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-mini",
    "prompt": "A small robot tending flowers in a glass greenhouse",
    "duration": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "camera_fixed": false
    }
  }'

参考媒体与生成控制

Dreamina 模型可通过 metadata.content 表达图片、视频或音频等参考内容。将文本提示词放在顶层 prompt，并按目标模型要求在 metadata.content 中传递媒体项目。

`metadata.content` 字段	类型	必填	说明
`type`	string	是	`image_url`、`video_url` 或 `audio_url`。
`image_url.url`	string	图片项时是	公开可访问的参考图片 URL。
`video_url.url`	string	视频项时是	公开可访问的参考视频 URL。具体模型是否支持视频参考以实际响应为准。
`audio_url.url`	string	音频项时是	公开可访问的参考音频 URL。

{
  "metadata": {
    "content": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.png" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } }
    ],
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5,
    "seed": 42
  }
}

完整的图片参考调用示例：

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-mini",
    "prompt": "保持参考角色的造型，在霓虹灯照亮的街道上自然行走，镜头缓慢跟拍",
    "duration": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "9:16",
      "content": [
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/character.png" }
        }
      ],
      "generate_audio": true,
      "watermark": false
    }
  }'

常用控制字段包括 resolution、ratio、duration、frames、seed、camera_fixed、watermark 和 generate_audio。如果同时传 frames 和 duration，上游以 frames 为准。Dreamina 的帧率按 24 fps 计算，因此时长范围对应 96 帧到模型最大时长乘以 24 帧。输出分辨率、时长和是否接受视频参考取决于具体模型版本。发送前确认所选模型的限制；不要使用某个版本的参数推断其他版本的能力。提交成功后保存响应中的 id。使用创建视频生成任务提交任务，并按异步任务工作流查看提交响应、查询响应和下载方式。