seedance-2.0-me

seedance-2.0-me 是 MoonApiX 的 Seedance-2 高质量视频模型，适合文生视频、首帧图生视频、多参考图和参考图绑定音频的视频生成。创建任务时，model 固定填写 seedance-2.0-me。

兼容说明：旧模型名 seedance-2.0-pro 仍可作为输入别名使用；新接入、价格页和模型列表统一展示 seedance-2.0-me。

所有请求都使用 MoonApiX 标准视频任务接口：

text

POST https://moonapix.com/v1/videos
GET  https://moonapix.com/v1/videos/{task_id}

新接入建议统一使用 images 数组描述输入图片素材，并用 role 标注素材用途。first_frame_url、reference_image_urls、content[] 等旧字段仍兼容，但不建议作为新系统的主协议。seedance-2.0-me 支持首帧或参考图模式；不要在同一次请求里混合 first_frame 和 reference_image。

能力概览

能力	支持情况
文生视频	支持
首帧图生视频	支持
多参考图	支持
尾帧参考	不支持 `last_frame_url`；请使用首帧图或参考图控制画面
参考视频	不支持。请不要使用 `reference_video_url`、`reference_video_urls`、`video_url`、`videos` 或 `content[]` 视频条目
参考图绑定音频	支持在 `content[]` 参考图条目上填写 `reference_voice`
独立参考音频	不支持 `audio_url`、`audio` 或 `audios`
推荐查询接口	`GET /v1/videos/{task_id}`

素材组合边界

seedance-2.0-me 支持多种图片素材模式，但同一个请求里请只选择一种主模式：

模式	可用写法	是否可与其它素材模式混用
首帧图生视频	`images[].role=first_frame`、`first_frame_url`、`image`、`image_url`	不要与 `reference_image` 混用
多参考图	`images[].role=reference_image`、`reference_image_url(s)`、`content[]` 图片条目	可以传多张参考图；不要与 `first_frame` 混用
参考图绑定音频	`content[]` 参考图条目上的 `reference_voice`	属于参考图模式；不要再混入独立音频

如果同一次请求混合了不支持的素材模式，接口会返回 400 unsupported_media_role 或 400 unsupported_media_combination。例如 reference_video、first_frame + reference_image 都会被拒绝；请删除视频参考，或只保留一种图片素材模式。

参数范围

参数	可选值	说明
`duration`	`5`、`10`、`15`	视频时长，单位秒。
`resolution`	`720P`、`1080P`	输出清晰度。不支持 `480P`。
`ratio` / `aspect_ratio`	`16:9`、`9:16`、`1:1`、`4:3`、`3:4`	视频画幅比例。
`prompt_extend`	`true` / `false`	是否自动扩展提示词。
`watermark`	`true` / `false`	是否添加水印。
`callback_url`	URL	任务完成后的回调地址。

resolution 建议使用大写值，例如 720P、1080P。如果传入 480P，请求会失败，请改用 720P 或 1080P。

创建文生视频

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-me",
    "prompt": "一位女子在明亮摄影棚里跳舞，动作自然流畅，镜头缓慢推进，电影感光影",
    "duration": 15,
    "resolution": "1080P",
    "ratio": "9:16",
    "prompt_extend": true,
    "watermark": false
  }'

创建成功后会返回任务 ID：

json

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-me",
  "status": "submitted",
  "progress": 0,
  "created_at": 1781374585
}

请保存 task_id，后续用它查询任务结果。

首帧图生视频

如果你希望视频从某张图片开始，推荐使用 images[].role=first_frame。图片需要是公网可访问的 http 或 https 地址。

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-me",
    "prompt": "图中女子开始跳舞，身体动作自然，裙摆轻微摆动，镜头轻轻环绕",
    "images": [
      {
        "url": "https://example.com/first-frame.png",
        "role": "first_frame"
      }
    ],
    "duration": 15,
    "resolution": "1080P",
    "ratio": "9:16",
    "prompt_extend": true,
    "watermark": false
  }'

兼容旧系统时，也可以使用 image 或 image_url 传入单张图片：

json

{
  "model": "seedance-2.0-me",
  "prompt": "让图片中的人物在舞台灯光下跳舞，动作优雅，镜头慢慢拉近",
  "image": "https://example.com/person.png",
  "duration": 10,
  "resolution": "720P",
  "ratio": "16:9"
}

content 写法

已经使用 OpenAI-compatible 多模态结构的系统，可以用 content[] 表达首帧图、参考图，以及参考图绑定音频。

json

{
  "model": "seedance-2.0-me",
  "duration": 15,
  "resolution": "1080P",
  "ratio": "9:16",
  "content": [
    {
      "type": "text",
      "text": "图中女子在跳舞，动作自然流畅，镜头轻微环绕，保持人物身份和服装一致"
    },
    {
      "type": "image_url",
      "role": "first_frame",
      "image_url": {
        "url": "https://example.com/first-frame.png"
      }
    }
  ]
}

多参考图

seedance-2.0-me 支持多参考图。多参考图请求里请只传 reference_image 图片，不要同时传首帧图或视频参考。推荐使用 images[] 对象数组：

bash

curl https://moonapix.com/v1/videos \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-me",
    "prompt": "参考多张图片中的人物造型和场景氛围，生成一段自然跳舞视频，镜头从全身推进到半身",
    "images": [
      {
        "url": "https://example.com/ref-1.jpg",
        "role": "reference_image"
      },
      {
        "url": "https://example.com/ref-2.jpg",
        "role": "reference_image"
      },
      {
        "url": "https://example.com/ref-3.jpg",
        "role": "reference_image"
      }
    ],
    "duration": 10,
    "resolution": "1080P",
    "ratio": "16:9",
    "prompt_extend": true,
    "watermark": false
  }'

兼容字符串数组写法：

json

{
  "model": "seedance-2.0-me",
  "prompt": "参考图片中的人物和服装，生成一段室内舞蹈视频，动作连贯，光影柔和",
  "images": [
    "https://example.com/ref-1.jpg",
    "https://example.com/ref-2.jpg"
  ],
  "duration": 10,
  "resolution": "720P",
  "ratio": "4:3"
}

参考视频

seedance-2.0-me 当前不支持视频参考。请不要传 videos[]、video_url、reference_video_url、reference_video_urls 或 content[] 视频条目。需要动作或运镜约束时，请用提示词描述，或改用明确支持视频参考的其它模型。

参考图绑定音频

如果你希望某张参考图带有声音参考，可以在 content[] 的参考图条目上填写 reference_voice。reference_voice 需要是公网可访问的音频 URL。

json

{
  "model": "seedance-2.0-me",
  "prompt": "参考图1中的人物外观，并参考音频的节奏感，生成15秒自然跳舞视频，动作流畅，镜头稳定",
  "duration": 15,
  "resolution": "1080P",
  "ratio": "9:16",
  "content": [
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "https://media.windfimusic.com/user-assets/image/2026/06/person.png?..."
      },
      "reference_voice": "https://media.windfimusic.com/user-assets/audio/2026/06/rhythm.mp3?..."
    }
  ]
}

reference_voice 是绑定在参考图上的音频字段，不是独立音频素材。seedance-2.0-me 不支持把音频作为独立素材传入，请不要使用 audio_url、audio 或 audios。

常用请求字段

字段	类型	必填	说明
`model`	string	是	固定填写 `seedance-2.0-me`。
`prompt`	string	是	视频描述。建议写清主体、动作、镜头、场景和风格。
`duration`	number	否	视频时长：`5`、`10`、`15`。
`resolution`	string	否	输出清晰度：`720P`、`1080P`。不支持 `480P`。
`ratio`	string	否	视频比例：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`。
`aspect_ratio`	string	否	与 `ratio` 等价，适合已有代码使用。
`first_frame_url`	string	否	首帧图 URL。
`image` / `image_url`	string	否	单张首帧图或参考图 URL；兼容旧写法，新接入优先用 `images[]`。
`reference_image_url`	string	否	单张参考图 URL。
`reference_image_urls`	string[]	否	多张参考图 URL。
`images`	array	否	图片素材数组，推荐条目格式为 `{ "url": "...", "role": "reference_image" }`。支持 `reference_image` 或 `first_frame`；同一次请求只选择一种图片模式。
`reference_video_url`	string	否	不支持。请不要在 `seedance-2.0-me` 请求中传入。
`reference_video_urls`	string[]	否	不支持。请不要在 `seedance-2.0-me` 请求中传入。
`video_url`	string	否	不支持。请不要在 `seedance-2.0-me` 请求中传入。
`videos`	array	否	不支持。请不要在 `seedance-2.0-me` 请求中传入。
`content`	array	否	多模态输入数组，可放文本和图片；参考图条目可填写 `reference_voice`。`seedance-2.0-me` 下不要传视频条目。
`prompt_extend`	boolean	否	是否自动扩展提示词。
`watermark`	boolean	否	是否添加水印。
`callback_url`	string	否	任务完成后的回调地址。

素材 URL 要求

图片和参考图绑定音频都必须是 MoonApiX 服务可访问的公网 http 或 https URL。
图片宽高都需要不低于 300 px，主体清晰，避免过度压缩、遮挡和水印。
如果外部素材链接可能过期，建议先调用 MoonApiX 上传接口创建托管 URL，再把返回的 url 或 oss_url 放到视频请求中。
多参考图之间建议保持人物、风格或场景一致，避免互相冲突。

上传素材示例：

bash

curl https://moonapix.com/v1/assets/uploads \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -F "file=@/path/to/image.png" \
  -F "mode=oss"

上传成功后，建议优先把响应里的 url 或 oss_url 传给 first_frame_url、image、reference_image_urls、images 或 reference_voice。上传只创建素材 URL，不会自动绑定到视频任务。

15 秒 1080P 首帧示例

下面是一个常见的正式出片请求：上传首帧图片后，把上传响应里的 url 或 oss_url 作为 first_frame_url，生成 15 秒 1080P 竖屏视频。

json

{
  "model": "seedance-2.0-me",
  "prompt": "图中女子在跳舞，保持人物外观一致，动作自然流畅，镜头稳定",
  "first_frame_url": "https://moonapix.com/assets/public/v2/.../first-frame.png",
  "duration": 15,
  "resolution": "1080P",
  "ratio": "9:16",
  "prompt_extend": false,
  "watermark": false
}

查询任务

bash

curl https://moonapix.com/v1/videos/task_xxx \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>"

进行中响应示例：

json

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-me",
  "status": "running",
  "progress": 42,
  "created_at": 1781374585
}

成功响应示例：

json

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "object": "video",
  "model": "seedance-2.0-me",
  "status": "succeeded",
  "progress": 100,
  "url": "https://example.com/result.mp4",
  "video_url": "https://example.com/result.mp4",
  "result_url": "https://example.com/result.mp4",
  "output": {
    "url": "https://example.com/result.mp4"
  },
  "metadata": {
    "url": "https://example.com/result.mp4"
  },
  "error": null
}

失败响应示例：

json

{
  "id": "task_xxx",
  "task_id": "task_xxx",
  "model": "seedance-2.0-me",
  "status": "failed",
  "error": {
    "message": "The request could not be completed. Please adjust the prompt or input image and try again."
  }
}

状态判断

状态	含义	处理方式
`pending`	MoonApiX 已受理，等待提交或系统准备。	继续查询。
`submitted`	已提交生成任务，等待开始处理。	继续查询。
`running`	正在生成。	继续查询。
`succeeded`	已完成。	读取视频地址。
`failed`	生成失败。	读取 `error.message`，调整输入后重试。
`cancelled`	任务已取消。	停止查询。

不要只根据是否出现 URL 判断任务是否成功。请先读取 status，只有 succeeded 才保存或播放视频地址。

视频地址读取顺序

任务成功后，建议按这个顺序读取视频地址：

text

video_url
result_url
url
object
output.url
metadata.url

不同 SDK 或兼容接口可能把同一个结果地址放在不同字段里。业务系统可以按上面的顺序取第一个非空 URL。部分视频直链可能不支持 HEAD 请求，验证可访问性时建议使用 GET 或带 Range: bytes=0-0 的 GET 请求。

回调地址

如果传入 callback_url，任务完成后 MoonApiX 会向该地址推送结果。业务系统仍建议保留轮询兜底逻辑，避免网络抖动导致回调丢失。

json

{
  "model": "seedance-2.0-me",
  "prompt": "产品在白色摄影棚中旋转展示，镜头缓慢推进，画面干净高级",
  "image": "https://example.com/product.png",
  "duration": 10,
  "resolution": "1080P",
  "ratio": "1:1",
  "callback_url": "https://example.com/webhooks/moonapix"
}

限制说明

能力或参数	说明
`480P`	不支持。请使用 `720P` 或 `1080P`。
素材数量	多参考图最多 5 张；首帧和参考图不要在同一次请求中混用。
尾帧参考	不支持 `last_frame_url`；如果需要控制结束画面，请在提示词中描述或使用参考图辅助。
参考图绑定音频	支持 `content[]` 参考图条目上的 `reference_voice`。
独立参考音频	不支持 `audio_url`、`audio` 或 `audios`。

常见问题

为什么传 480P 会失败？

seedance-2.0-me 当前只支持 720P 和 1080P。请把 resolution 改为 720P 或 1080P 后重新提交。

图片已经上传，为什么图生视频没有生效？

上传图片只会生成可访问的图片 URL，不会自动绑定到后续视频任务。创建视频任务时，需要把素材 URL 显式放入 first_frame_url、image、reference_image_urls、images 或 content[] 中。

为什么传参考视频会失败？

seedance-2.0-me 当前不支持视频参考。请删除 videos[]、video_url、reference_video_url、reference_video_urls 或 content[] 视频条目后重新提交。

任务一直是 RUNNING 怎么办？

继续用同一个 task_id 查询，不要重复提交同一任务。若长时间没有完成，请记录 task_id、request_id 或 trace_id 交给 MoonApiX 支持排查。

失败后需要提供哪些信息？

建议保存并提供：

task_id
request_id 或 trace_id
请求体中的 model、duration、resolution、ratio
使用的图片 URL
返回的 error.message

最佳实践

提示词里写清主体、动作、镜头、场景和风格，例如“图中女子在跳舞，镜头轻微环绕，保持人物身份一致”。
首帧图尽量使用清晰正脸或主体完整的图片。
需要正式出片时优先使用 1080P；需要更快试跑时可先用 720P。
多参考图控制在 2 到 5 张，并确保主体、动作和风格一致。
业务系统保存 task_id、请求参数、最终视频地址、request_id 或 trace_id，方便排查。

对话协议

向量

音频

模型

Ideogram 图像

Midjourney 任务

Seedance-2 视频

seedance-2.0-me

能力概览

素材组合边界

参数范围

创建文生视频

首帧图生视频

content 写法

多参考图

参考视频

参考图绑定音频

常用请求字段

素材 URL 要求

15 秒 1080P 首帧示例

查询任务

状态判断

视频地址读取顺序

回调地址

限制说明

常见问题

为什么传 480P 会失败？

图片已经上传，为什么图生视频没有生效？

为什么传参考视频会失败？

任务一直是 RUNNING 怎么办？

失败后需要提供哪些信息？

最佳实践

相关页面

Ideogram 图像

Midjourney 任务

Seedance-2 视频

seedance-2.0-me ​

能力概览 ​

素材组合边界 ​

参数范围 ​

创建文生视频 ​

首帧图生视频 ​

content 写法 ​

多参考图 ​

参考视频 ​

参考图绑定音频 ​

常用请求字段 ​

素材 URL 要求 ​

15 秒 1080P 首帧示例 ​

查询任务 ​

状态判断 ​

视频地址读取顺序 ​

回调地址 ​

限制说明 ​

常见问题 ​

为什么传 480P 会失败？ ​

图片已经上传，为什么图生视频没有生效？ ​

为什么传参考视频会失败？ ​

任务一直是 RUNNING 怎么办？ ​

失败后需要提供哪些信息？ ​

最佳实践 ​

相关页面 ​

seedance-2.0-me

能力概览

素材组合边界

参数范围

创建文生视频

首帧图生视频

content 写法

多参考图

参考视频

参考图绑定音频

常用请求字段

素材 URL 要求

15 秒 1080P 首帧示例

查询任务

状态判断

视频地址读取顺序

回调地址

限制说明

常见问题

为什么传 480P 会失败？

图片已经上传，为什么图生视频没有生效？

为什么传参考视频会失败？

任务一直是 RUNNING 怎么办？

失败后需要提供哪些信息？

最佳实践

相关页面