MoonNexAI API Docs

简体中文

English

简体中文

English

外观

Dreamina Seedance 2.0 / Dreamina Seedance 2.5 ​

本页集中介绍 Dreamina Seedance 2.0 与 Dreamina Seedance 2.5。两者使用独立模型 ID，可通过通用视频接口或火山格式兼容接口调用。请先在控制台或 GET /v1/models 确认账号可用模型；文档收录不代表当前账号已经开通。

模型与参数 ​

项目Dreamina Seedance 2.0Dreamina Seedance 2.5
模型 IDdreamina-seedance-2-0-260128dreamina-seedance-2-5-260628
时长4–15 秒4–30 秒
参考图调用示例两张参考图两张参考图
示例分辨率与比例720p、16:9720p、16:9
4K以模型实时能力为准不支持
素材 ID 认证未验收；示例使用公网图片 URL未验收；示例使用公网图片 URL

不要把一个版本的时长、分辨率或参考素材限制套用到另一个版本。视频参考、音频参考、首尾帧、回调和其他高级参数应以当前模型能力及实际请求校验为准；本页两图示例不代表所有组合都已验收。

能力矩阵 ​

能力Dreamina Seedance 2.0Dreamina Seedance 2.5
文生视频以账号模型能力为准以账号模型能力为准
图生视频支持本页公网参考图格式支持本页公网参考图格式
多参考图本页示例为 2 张本页示例为 2 张
首帧/尾帧以模型校验结果为准以模型校验结果为准；不得把固定比例示例误用于 adaptive 模式
视频参考、音频参考以模型能力矩阵为准以模型能力矩阵为准
回调以账号和接口返回为准以账号和接口返回为准

公共请求字段 ​

字段类型说明
modelstringdreamina-seedance-2-0-260128 或 dreamina-seedance-2-5-260628。
promptstring场景、动作、镜头和参考图绑定说明。
references[]array参考媒体；图片使用 media_type=image、role=reference_image 和可匿名下载的 HTTPS url。
durationnumber2.0 为 4–15；2.5 为 4–30。单位为秒。
aspect_ratiostring例如 16:9。只有模型允许的比例会被接受。
resolutionstring例如 720p。响应中的实际媒体仍需下载后检查。

服务端会保留显式传入的 false 和 0。客户端不要用 omitempty 或空值合并逻辑删除用户明确传入的值，也不要同时发送两套互相冲突的参考字段。

通用视频接口 ​

POST /v1/videos 使用 prompt、references、duration、aspect_ratio 和 resolution。

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "prompt": "Create a smooth cinematic transition using the two reference images.",
    "references": [
      {"media_type": "image", "role": "reference_image", "url": "https://example.com/reference-1.jpg"},
      {"media_type": "image", "role": "reference_image", "url": "https://example.com/reference-2.jpg"}
    ],
    "duration": 15,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

替换示例图片地址为你有权使用、无需登录即可下载的 HTTPS 图片地址。角色 reference_image 表示参考图，不自动等于首帧或尾帧。使用 Dreamina Seedance 2.0 时替换模型 ID，并保持时长不超过 15 秒。Dreamina Seedance 2.5 可将 duration 设置为 30。

2.0 的最小请求示例：

bash
curl https://moonnexai.com/v1/videos \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-260128",
    "prompt": "Animate the two reference images with a slow camera move.",
    "references": [
      {"media_type": "image", "role": "reference_image", "url": "https://example.com/reference-1.jpg"},
      {"media_type": "image", "role": "reference_image", "url": "https://example.com/reference-2.jpg"}
    ],
    "duration": 15,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

2.5 的请求可以使用上面的 15 秒示例，也可以把 duration 改为 30；2.0 不能使用 30 秒。

保存创建响应的公开任务 ID，查询：

bash
curl https://moonnexai.com/v1/videos/video_example \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>"

先检查 status 和 error。只有任务成功（completed 或接口返回的成功状态）才读取结果 url；仅出现 URL 不代表生成成功。排队或生成中继续轮询，失败时读取安全错误信息并停止轮询。

火山格式兼容接口 ​

POST /api/v3/contents/generations/tasks 接受 content[]、ratio、resolution 和 duration。这是请求格式兼容，不代表可以使用其他平台的 API Key 或素材 ID。

bash
curl https://moonnexai.com/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      {"type": "text", "text": "Create a smooth cinematic transition using the two reference images."},
      {"type": "image_url", "image_url": {"url": "https://example.com/reference-1.jpg"}, "role": "reference_image"},
      {"type": "image_url", "image_url": {"url": "https://example.com/reference-2.jpg"}, "role": "reference_image"}
    ],
    "duration": 15,
    "ratio": "16:9",
    "resolution": "720p"
  }'
操作方法与路径
创建任务POST /api/v3/contents/generations/tasks
查询单个任务GET /api/v3/contents/generations/tasks/{id}
列出自己的任务GET /api/v3/contents/generations/tasks

单任务查询先检查 status 和 error，成功状态 succeeded 下读取 content.video_url。列表支持 page_num、page_size、filter.status、filter.model、filter.service_tier 和可重复的 filter.task_ids；默认查询最近 7 天、默认服务层级，只返回当前认证身份有权访问的任务。

显式 false 和 0 会作为参数值处理，请勿在客户端清理请求体时丢弃。能传递某字段不代表当前模型支持该值；校验失败时按错误提示调整。

响应与轮询 ​

创建接口返回公开任务 ID 后，任务通常先处于排队或生成状态：

json
{
  "id": "video_example",
  "status": "queued",
  "model": "dreamina-seedance-2-5-260628"
}

轮询直到终态。成功响应示例：

json
{
  "id": "video_example",
  "status": "completed",
  "model": "dreamina-seedance-2-5-260628",
  "output": {"url": "https://media.example.com/video.mp4"}
}

不同兼容层可能使用 succeeded、completed、failed 或 cancelled；以当前接口返回的状态枚举为准。只有成功终态才读取 url、video_url 或 output.url。queued、submitted、running、failed 和 cancelled 状态不得当作可下载结果。

常见失败原因包括模型未开通、时长或比例超出能力、参考 URL 无法匿名抓取、素材角色不合法和余额或分组权限不足。先读取安全的 error.code、error.message 和 param，修正请求后再重试；不要仅因为响应中出现 URL 就跳过状态检查。

结果下载 ​

成功任务可使用返回的媒体 URL，或访问 GET /v1/videos/{id}/content。内容接口需要本站 API Key，支持 HEAD 与 Range 续传，可返回 307 到可下载媒体地址。

下载客户端跟随跨域重定向时，不得向媒体域名转发 Authorization。普通 cURL -L 会限制跨主机认证转发，不要使用 --location-trusted。临时地址应及时下载保存；不要依赖结果 URL 永久有效。

计费与排障 ​

当前金额以控制台和实际计费记录为准。Dreamina Seedance 按计费策略记录的输出 Token 结算；创建时预扣与完成后的实际费用可能不同，差额按策略补扣或退回。币种以账号显示为准。

提交失败且没有创建任务不应视为成功计费；任务失败时查看任务终态和退款或结算记录。反馈问题请提供本站公开任务 ID、请求时间、模型 ID、时长、分辨率与错误码，不要发送 API Key。

素材 ID 认证暂不纳入本页已验收能力。请使用公网图片 URL；不要把 Asset:// 格式转换理解为认证已经通过。