Seedance 2.0 Mini API

What it does

Seedance 2.0 Mini makes a video of 4 to 15 seconds, with a synchronized soundtrack by default, from a prompt and optional media, at 480p or 720p. Everything goes in one list, input.content: text items carry the prompt, and each image_url, video_url and audio_url item names its role. The items you send choose the mode:

This model does not edit or extend a video and has no draft mode: omni_reference_task_type, draft and draft_task are refused. For those, use Seedance 2.5; for 1080p or 4K, use Seedance 2.0 Pro.

Every example below is a complete body for POST /v1/generations. Send the same body to POST /v1/estimates first: it is free, creates no task, holds no Credits, and refuses an invalid body with the same 422 as a create. The https://media.vizoapi.com/... files are public samples, so the examples run as they are; replace https://example.com/... with your own file or an uploaded ast_... asset ID.

Modes

Text to video

Only text items. Set ratio to one of 16:9, 4:3, 1:1, 3:4, 9:16 or 21:9; with adaptive (the default) the model picks one. duration is 4 to 15 seconds, default 5, or -1 to let the model choose. resolution is 480p or 720p (default); 1080p and 4k are refused (value_not_allowed).

{
  "model": "seedance-2-0-mini",
  "input": {
    "content": [
      { "type": "text", "text": "A paper boat drifts across a still pond at dawn, mist on the water, slow push-in, soft natural light" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": true
  }
}

First frame

The video starts on your image. Send one image_url with role first_frame; a second one is refused (rule first_frame_repeated). With ratio adaptive the output takes the image's aspect ratio; other ratios are accepted too. The prompt describes what happens next.

{
  "model": "seedance-2-0-mini",
  "input": {
    "content": [
      { "type": "text", "text": "The hominids step back as the sun rises behind the monolith, slow push-in" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/monolith.jpg" } }
    ],
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": 5
  }
}

First and last frame

The video moves from the first image to the last. Send at most one first_frame and one last_frame; a last_frame without a first_frame is refused (rule last_frame_needs_first_frame). Frames cannot be combined with any reference image, video or audio (rule frames_with_references).

{
  "model": "seedance-2-0-mini",
  "input": {
    "content": [
      { "type": "text", "text": "The ring-shaped station slowly turns to face the camera as an amber planet rises behind it" },
      { "type": "image_url", "role": "first_frame", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg" } },
      { "type": "image_url", "role": "last_frame", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/ending.jpg" } }
    ],
    "resolution": "720p",
    "ratio": "adaptive",
    "duration": 6
  }
}

Reference images

Up to 9 images with role reference_image give the model characters, objects, places or a style to reuse; a tenth is refused (rule too_many_images). Unlike frames, they do not fix the first or last picture, so any ratio works. Name them in the prompt by their order (see [Prompting tips](#prompting-tips)).

{
  "model": "seedance-2-0-mini",
  "input": {
    "content": [
      { "type": "text", "text": "Shot 1: the black monolith from image 1 stands on a savanna at dawn. Shot 2: match cut to the ring-shaped space station from image 2, tumbling slowly in black space." },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/monolith.jpg" } },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg" } }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 8
  }
}

Reference video and audio

Reference videos (motion, camera, pacing) and reference audio (rhythm, voice, sound) can be mixed with reference images: up to 3 videos and 3 audio items, each 2 to 15 seconds, with the videos together and the audio together at most 15 seconds each. Audio needs at least one image or video in content (rule audio_needs_visual). The output is always a new video; the source video is not edited or extended.

Any video_url item moves the task to the -video tier of its resolution, which bills the input video's seconds too (see [How it is billed](#how-it-is-billed)).

{
  "model": "seedance-2-0-mini",
  "input": {
    "content": [
      { "type": "text", "text": "Follow the camera movement and pacing of video 1, set on the space station from image 1, cut to the beat of audio 1" },
      { "type": "image_url", "role": "reference_image", "image_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/keyframes/station.jpg" } },
      { "type": "video_url", "role": "reference_video", "video_url": { "url": "https://media.vizoapi.com/samples/seedance-2-5/odyssey-v1/1.mp4" } },
      { "type": "audio_url", "role": "reference_audio", "audio_url": { "url": "https://example.com/beat.mp3" } }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 8
  }
}

Input limits

A media value is a public https URL (up to 4,000 characters) or an ast_... asset ID from your project. Plain http, private or local addresses, URLs with a user name or #fragment, and Base64 data are refused with 422 (rule bad_format). The model fetches a linked file itself, possibly some time after acceptance, so keep it reachable until the task closes; if it cannot, the task fails with input_media_unreachable. See Model inputs and media.

Output

A succeeded task lists one MP4 in result.outputs: take its asset_id and get a download URL with download an asset. With return_last_frame, result.last_frame_asset_id is the PNG. result.metadata reports what was made when the model returns it, such as duration, resolution, ratio and seed. Outputs are kept for 7 days. See Get results.

How it is billed

The input selects the tier: resolution alone, or resolution plus -video when content has any video_url. Images and audio never change the tier or the price, and neither do ratio, generate_audio, seed or watermark.

Input seconds are the length of all input videos together, rounded down, at most 15. When a video's length cannot be read at create, the hold counts 15 input seconds. When the model chooses the length (duration: -1), the hold counts 15 output seconds.

Holds at 720p:

A 5-second text video holds 42.000 Credits at 480p, and the same with a 10-second reference video holds 75.000 Credits.

The hold is only the estimate. A succeeded task is charged from the usage the model reports, at the tier's rate, so price.charged can be below the hold (the rest is released) or above it, with no cap. Usage above the hold comes from your available balance; what it cannot cover is owed, and new creates get 402 balance_negative until a top-up. A failed, canceled or unresolved task is not charged. Send the body to POST /v1/estimates to see the exact hold and its basis (output_seconds, input_seconds, billed_seconds, auto). See Billing.

Errors and behaviors

Moderation is always on; no field turns it off. Each task has a deadline, execution_expires_after: 3600 to 259200 seconds (1 to 72 hours) from acceptance, default 86400. A task still unfinished then closes as unresolved, releases its hold and is not charged; if its result arrives later, it is added at no charge and late_result_available becomes true. See Errors and Get results.

Prompting tips

• Name reference media by kind and order in content: "image 1", "image 2", "video 1", "audio 1". Say what to take from each: "the character from image 1", "the camera movement of video 1", "the rhythm of audio 1".
• Write the shot, not just the subject: subject, action, setting, camera movement, light and style, in that order. For several shots, number them ("Shot 1: …, Shot 2: …") and give each its own camera move.
• Describe the sound you want when generate_audio is on: ambience, effects, music or none, and any spoken line in quotes.
• With first and last frames, describe the motion between them; the frames already fix the start and end.
• Put settings in fields, never in the prompt: --ratio 16:9 style flags are refused.
• Settle the prompt at 480p, then render the version you keep at 720p.

价格

输入决定价格档位。视频按输出秒数计费；含输入视频的档位同时计入输入秒数。

规则

• content needs at least one text, image or video item.
• Every image, video and audio item in content names its role.
• Input limits: up to 9 images, 3 videos and 3 audio items in content, with no limit on the total. Each video and audio item runs 2 to 15 seconds. Videos add up to at most 15 seconds, and audio to at most 15 seconds. Lengths are checked before the task is created when the file can be measured (422 input_duration_out_of_range). Task type and drafts are not supported.
• Image pixel size and aspect ratio, and video resolution and frame rate, are not checked when the request is made: the model checks them when the task runs, and a file it refuses usually fails the task with input_media_invalid (otherwise generation_failed); the task is not charged.
• first_frame and last_frame images (at most one each) cannot be combined with reference images, videos or audio, and a last_frame needs a first_frame.
• Audio items need at least one image or video in content.
• Prompt text must not contain inline --flag parameters.

输入字段

在 input 中发送这些字段。表中没有的字段会被拒绝，返回 HTTP 422 invalid_input。

示例

完整的创建请求、202 响应，以及任务成功后的状态。

请求

curl https://api.vizoapi.com/v1/generations \
  -H "Authorization: Bearer $VIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2-0-mini",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A paper boat drifting on a pond at dawn, slow dolly in"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}'

import os, requests

# Send once: do not retry this request automatically.
task = requests.post(
    "https://api.vizoapi.com/v1/generations",
    headers={"Authorization": f"Bearer {os.environ['VIZO_API_KEY']}"},
    json={
      "model": "seedance-2-0-mini",
      "input": {
        "content": [
          {
            "type": "text",
            "text": "A paper boat drifting on a pond at dawn, slow dolly in"
          }
        ],
        "resolution": "720p",
        "ratio": "16:9",
        "duration": 5
      },
      "metadata": {
        "client_reference": "my-unique-reference-1"
      }
    },
    timeout=60,
).json()
print(task["id"], task["status"])

// Send once: do not retry this request automatically.
const res = await fetch("https://api.vizoapi.com/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VIZO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "seedance-2-0-mini",
    "input": {
      "content": [
        {
          "type": "text",
          "text": "A paper boat drifting on a pond at dawn, slow dolly in"
        }
      ],
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5
    },
    "metadata": {
      "client_reference": "my-unique-reference-1"
    }
  }),
});
const task = await res.json();
console.log(task.id, task.status);

响应

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "seedance-2-0-mini",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "92.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "seedance-2-0-mini",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "92.000",
    "reserved": "0.000",
    "charged": "92.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "video/mp4"
      }
    ]
  }
}