跳转到主要内容
POST
/
api
/
v1
/
task
/
submit
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2.0",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "吹灭蜡烛",
    "mediaUrls": ["https://example.com/photo.jpg"],
    "ratio": "16:9",
    "resolution": "1080p",
    "duration": 5,
    "fallback": true
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
通过传入图片、视频、音频等素材生成视频。根据素材数量和类型自动选择生成模式。
Seedance 视频生成耗时可能在 2 分钟到 4 小时之间，具体取决于上游官方接口的排队情况。使用该模型时，建议你务必配置 callBackUrl，这样结果一旦生成完成即可及时回调通知。不建议持续轮询 Query Task 接口。
关于 Seedance 专属的内容审核、退款规则和违规附加扣费，请参见 内容审核与处罚。

​
支持的素材类型

类型支持格式说明支持模型
图片.jpg, .jpeg, .png, .webp, .gif, .bmp用于首尾帧或参考图所有模型
视频.mp4, .mov, .m4v用于多模态参考（上传视频总时长不超过 15 秒）仅 seedance-2.0、seedance-2.0-fast
音频.mp3, .wav用于多模态参考（不超过 15 秒）仅 seedance-2.0、seedance-2.0-fast
视频和音频素材仅 seedance-2.0 和 seedance-2.0-fast 支持。seedance-1.5-pro 模型仅支持最多 2 张图片（首尾帧模式）。
​
model
string
必填
模型名称，如 seedance-2.0、seedance-2.0-fast、seedance-1.5-pro。
​
callBackUrl
string
Webhook 回调地址。强烈建议用于 Seedance 视频任务，因为生成耗时可能在 2 分钟到 4 小时之间，取决于上游官方接口排队情况。
​
input
object
必填
如果请求因参数校验失败，任务中的 failure_reason 会返回 INVALID_PARAMETERS。对于 mediaUrls，请优先按以下顺序检查：素材 URL 数量是否为 1 到 12 个、图片是否不超过 9 张、上传视频总时长是否不超过 15 秒、上传音频总时长是否不超过 15 秒。
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2.0",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "吹灭蜡烛",
    "mediaUrls": ["https://example.com/photo.jpg"],
    "ratio": "16:9",
    "resolution": "1080p",
    "duration": 5,
    "fallback": true
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
生成模式

根据素材的数量和类型，自动选择不同模式：
条件模式说明支持模型
1 张图片首帧模式图片作为视频首帧所有模型
2 张图片首尾帧模式两张图片分别作为首帧和尾帧所有模型
3+ 张图片多图参考模式通过 @1、@2、@3 引用多张图片仅 seedance-2.0、seedance-2.0-fast
包含视频或音频多模态参考模式图片、视频、音频混合作为参考素材仅 seedance-2.0、seedance-2.0-fast

​
1 张图 — 首帧模式

以图片作为视频的第一帧，根据 prompt 生成后续动画。 
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "吹灭蜡烛",
    "mediaUrls": ["https://example.com/dog.webp"]
  }
}

​
2 张图 — 首尾帧模式

第一张图作为视频首帧，第二张图作为视频尾帧，AI 自动生成中间过渡动画。 
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "变身",
    "mediaUrls": [
      "https://example.com/3d-cartoon.jpg",
      "https://example.com/dog.webp"
    ]
  }
}

​
3+ 张图 — 多图参考模式（仅 Seedance）

prompt 中用 @1、@2、@3 引用对应位置的素材。 
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "@1 和 @2 在聊天，@3 在旁边看",
    "mediaUrls": [
      "https://example.com/person-a.jpg",
      "https://example.com/person-b.jpg",
      "https://example.com/person-c.jpg"
    ]
  }
}

​
多模态参考模式（仅 Seedance）

当素材中包含视频或音频（或图片 + 视频 + 音频的任意混合）时，自动进入多模态参考模式。用 @1、@2 等引用对应位置的素材。
音频文件时长不能超过 15 秒，且上传视频总时长不能超过 15 秒，超过将被拒绝。
图片 + 音频 — 让角色随音乐节奏舞动： 
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "@1 随着 @2 的节奏跳舞",
    "mediaUrls": [
      "https://example.com/dancer.jpg",
      "https://example.com/music.mp3"
    ],
    "ratio": "16:9",
    "duration": 8
  }
}
图片 + 视频 — 以视频作为动作参考，结合图片角色： 
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "@1 做出 @2 中的动作",
    "mediaUrls": [
      "https://example.com/character.jpg",
      "https://example.com/reference-motion.mp4"
    ]
  }
}
多类型混合 — 自由组合图片、视频和音频： 
{
  "model": "seedance-2.0",
  "input": {
    "prompt": "@1 和 @2 随着 @3 一起跳舞",
    "mediaUrls": [
      "https://example.com/person-a.jpg",
      "https://example.com/person-b.jpg",
      "https://example.com/bgm.mp3"
    ],
    "duration": 10
  }
}

​
查询结果

通过查询任务接口或 Webhook 获取生成结果： 
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "SUCCESS",
    "input": {
      "model": "seedance-2.0",
      "prompt": "@1 随着 @2 的节奏跳舞",
      "mediaUrls": [
        "https://example.com/dancer.jpg",
        "https://example.com/music.mp3"
      ]
    },
    "result": {
      "type": "video",
      "urls": [
        "https://example.com/output/video-example.mp4"
      ]
    },
    "created_at": "2026-02-10T23:00:00.000000Z",
    "updated_at": "2026-02-10T23:03:25.000000Z"
  }
}