seedance-2.5 API

使用精确模型 ID seedance-2.5。请求中的模型名必须与本页完全一致。

示例输出seedance-2.5POST /v1/videos5.1s

请求参数：duration=5resolution=1080pratio=16:9

提示词：A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

生成该示例的请求

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

认证与入口

使用 Modelflare API Key，通过 https://modelflare.dev/v1 发送请求。网关入口为 POST /v1/videos。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

创建任务

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "一只白猫在雨夜霓虹街道上奔跑，电影感跟拍"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

任务查询与下载

提交成功后保存任务 ID。使用 GET /v1/videos/{task_id} 轮询，完成后使用 GET /v1/videos/{task_id}/content 下载；结果地址可能过期，应及时转存。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

请求要点

Seedance 使用 content[] 表达文字、帧和参考媒体；资产管理接口单独记录在Seedance 素材管理中。

注意

虚拟人像图片请先上传到Seedance 素材库，等到状态为 Active 后，在 content[] 中改用 asset://素材ID。Modelflare 不提供真人认证。

请求参数

Seedance 采用统一的多模态异步请求。将文字和媒体按顺序放入 content[]，媒体角色决定首帧、尾帧或参考素材工作流。

字段	必填	说明
model	是	seedance-2.5
content[]	是	text、image_url、video_url、audio_url；用 role 标记媒体用途
resolution	否	480p / 720p / 1080p
ratio	否	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	否	-1 自动选择，或 4–30 秒
generate_audio	否	是否生成同步对白、音效和背景音
tools	否	仅在官方支持的文生视频场景使用 web_search
watermark	否	是否添加水印
omni_reference_task_type	否	auto / reference / edit / extend；编辑与延长会收紧 ratio/duration 要求
output_format	否	mp4 / mov
return_last_frame	否	是否返回最终帧图片

输入与输出限制

当前模型支持 480p、720p、1080p；时长可使用 -1 自动选择，或填写 4–30 秒。最多可组合 30 张图片、10 段视频和 10 段音频。普通参考生成可用显式比例或 adaptive；编辑、续写和首/尾帧工作流必须使用 ratio: "adaptive"，编辑时 duration 必须为 -1。 虚拟人像图片必须先上传到素材库；Modelflare 不提供真人认证。

官方工作流示例

Seedance 2.5 会根据媒体角色和任务类型区分普通参考、编辑、续写和首尾帧工作流。下面的字段保持 官方契约，只有入口和模型 ID 改为 Modelflare。

普通参考

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

视频编辑

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

视频续写

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

首尾帧

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

错误与失败任务

参数不符合模型契约时，创建接口会返回带 request ID 的 4xx。异步任务也可能在创建成功后进入 failed；轮询响应中的 error_code 和 error_message 才是该任务的最终原因。不要把同一请求改成另一种 JSON 结构重试。

支持范围

本页只覆盖 Modelflare 的模型生成/编辑调用。搜索或地图增强、声音管理、元素库管理等资源型接口不属于本页的公开调用范围，也不需要作为模型请求字段传入。

价格与计费

本模型按 Token 计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

注意

本页只说明 Modelflare 的公开接口；可用字段和限制以本页当前版本为准。

变体

模型 ID	差异
seedance-2.5	本页说明的模型。