跳转到内容
打开 Castaly控制台

视频

seedance-2.5-nsfw API

通过 Modelflare 异步视频入口使用精确的 seedance-2.5-nsfw 模型 ID。

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

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

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

提示词:One continuous take, no cuts. The shallow steps at the end of a hotel pool, early evening. A blonde woman with a curvy full figure, in a white bikini and tortoiseshell glasses. She walks up out of the water, turns at the top step to face the camera, squeezes the water out of her hair with one hand and settles front on to the lens, water still running off her. Warm low sun from the right, cool blue pool light behind. Low camera close to her, easing back as she turns and keeping her framed from shoulders to hips, shallow depth of field. Real weight and inertia, natural hair and fabric movement, no text.

该示例为刻意选取的温和素材,不代表该模型 ID 的内容尺度上限。

生成该示例的请求
{
"model": "seedance-2.5-nsfw",
"prompt": "One continuous take, no cuts. The shallow steps at the end of a hotel pool, early evening. A blonde woman with a curvy full figure, in a white bikini and tortoiseshell glasses. She walks up out of the water, turns at the top step to face the camera, squeezes the water out of her hair with one hand and settles front on to the lens, water still running off her. Warm low sun from the right, cool blue pool light behind. Low camera close to her, easing back as she turns and keeping her framed from shoulders to hips, shallow depth of field. Real weight and inertia, natural hair and fabric movement, 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-nsfw",
"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 采用统一的多模态异步请求。将文字和媒体按顺序放入 content[],媒体角色决定首帧、尾帧或参考素材工作流。

字段 必填 说明
model 是 seedance-2.5-nsfw
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。 仿真人、真人照片和写实人脸必须先上传到素材库,不能直接提交图片地址或 Base64。

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-nsfw",
"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-nsfw", "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-nsfw", "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-nsfw", "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 计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

模型 ID 差异
seedance-2.5-nsfw 本页说明的模型。
seedance-2.5 基础模型。入口、请求结构和计费单位与本页相同,只需替换模型 ID;详见该模型页,价格与可用性见价格页。
媒体契约 · v1

契约 ID: media.seedance-2-5-nsfw.v1Adapter: video.seedance.25.v1@v1指纹: 56d7caca6df741d554717bacada009fe7592767a967842ad32cd20c9151f2164

官方来源: ByteDance / Volcengine

契约参数

Intent 字段控件选项
ratioselect16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive
resolutionselect480p / 720p / 1080p
durationselect-1 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30
audioswitch—
workflowselectauto / reference / edit / extend
output_formatselectmp4 / mov
return_last_frameswitch—

支持能力

  • allowed_values · ratio · 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive
  • allowed_values · resolution · 480p, 720p, 1080p
  • allowed_values · duration · -1, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
  • max_assets · reference_asset_ids · 50
  • prompt_optional_with_reference · prompt

结构化请求示例

text

Intent

{
  "audio": false,
  "duration": -1,
  "output_format": "mp4",
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "ratio": "16:9",
  "resolution": "480p",
  "return_last_frame": false,
  "workflow": "auto"
}

上游请求

{
  "content": [
    {
      "text": "A red paper kite over a quiet harbour at dusk.",
      "type": "text"
    }
  ],
  "duration": -1,
  "generate_audio": false,
  "model": "seedance-2.5-nsfw",
  "output_format": "mp4",
  "ratio": "16:9",
  "resolution": "480p",
  "return_last_frame": false,
  "seconds": "-1"
}

reference

Intent

{
  "audio": false,
  "duration": -1,
  "output_format": "mp4",
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "ratio": "16:9",
  "resolution": "480p",
  "return_last_frame": false,
  "workflow": "reference"
}

上游请求

{
  "content": [
    {
      "text": "A red paper kite over a quiet harbour at dusk.",
      "type": "text"
    },
    {
      "image_url": {
        "url": "https://example.com/reference.png"
      },
      "role": "reference_image",
      "type": "image_url"
    }
  ],
  "duration": -1,
  "generate_audio": false,
  "model": "seedance-2.5-nsfw",
  "omni_reference_task_type": "reference",
  "output_format": "mp4",
  "ratio": "16:9",
  "resolution": "480p",
  "return_last_frame": false,
  "seconds": "-1"
}

edit

Intent

{
  "audio": false,
  "duration": -1,
  "output_format": "mp4",
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "ratio": "adaptive",
  "resolution": "480p",
  "return_last_frame": false,
  "workflow": "edit"
}

上游请求

{
  "content": [
    {
      "text": "A red paper kite over a quiet harbour at dusk.",
      "type": "text"
    },
    {
      "role": "reference_video",
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      }
    }
  ],
  "duration": -1,
  "generate_audio": false,
  "model": "seedance-2.5-nsfw",
  "omni_reference_task_type": "edit",
  "output_format": "mp4",
  "ratio": "adaptive",
  "resolution": "480p",
  "return_last_frame": false,
  "seconds": "-1"
}

extend

Intent

{
  "audio": false,
  "duration": -1,
  "output_format": "mp4",
  "prompt": "A red paper kite over a quiet harbour at dusk.",
  "ratio": "adaptive",
  "resolution": "480p",
  "return_last_frame": false,
  "workflow": "extend"
}

上游请求

{
  "content": [
    {
      "text": "A red paper kite over a quiet harbour at dusk.",
      "type": "text"
    },
    {
      "role": "reference_video",
      "type": "video_url",
      "video_url": {
        "url": "https://example.com/reference.mp4"
      }
    }
  ],
  "duration": -1,
  "generate_audio": false,
  "model": "seedance-2.5-nsfw",
  "omni_reference_task_type": "extend",
  "output_format": "mp4",
  "ratio": "adaptive",
  "resolution": "480p",
  "return_last_frame": false,
  "seconds": "-1"
}