> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modelhunter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.0 Multimodal Video

> Generate controllable cinematic videos with Seedance 2.0 using text, optional image, video, and audio references.

## Body Parameters

<ParamField body="model" type="string" required>
  Seedance 2.0 model to use:

  * `bytedance/seedance-2`
</ParamField>

<ParamField body="input" type="object" required>
  Input parameters for the generation.

  <Expandable title="properties">
    <ParamField body="prompt" type="string" required>
      Text description of the video to generate. Maximum length: 5000 characters.
    </ParamField>

    <ParamField body="first_frame_url" type="string">
      Optional first frame image URL. Must be a public HTTP(S) URL.
    </ParamField>

    <ParamField body="last_frame_url" type="string">
      Optional last frame image URL. Must be a public HTTP(S) URL.
    </ParamField>

    <ParamField body="reference_image_urls" type="string[]">
      Optional image reference URLs. Provide 1 to 9 public HTTP(S) URLs.
    </ParamField>

    <ParamField body="reference_video_urls" type="string[]">
      Optional video reference URLs. Provide 1 to 3 public HTTP(S) URLs.

      Video-reference requests use the video-reference price tier and are billed on input plus output seconds.
    </ParamField>

    <ParamField body="reference_audio_urls" type="string[]">
      Optional audio reference URLs. Provide 1 to 3 public HTTP(S) URLs. Supported audio files are MPEG, WAV, X-WAV, AAC, MP4, or OGG, max 15MB each.

      Audio references must be used with at least one visual reference: `first_frame_url`, `last_frame_url`, `reference_image_urls`, or `reference_video_urls`.
    </ParamField>

    <ParamField body="generate_audio" type="boolean" default={false}>
      Whether to generate synchronized AI audio for the output video.
    </ParamField>

    <ParamField body="resolution" type="string" default="720p">
      Output resolution. Options: `480p`, `720p`, `1080p`.
    </ParamField>

    <ParamField body="aspect_ratio" type="string" default="16:9">
      Output aspect ratio. Options: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`.
    </ParamField>

    <ParamField body="duration" type="number" default={5}>
      Output duration in seconds. Must be an integer from `4` to `15`.
    </ParamField>

    <ParamField body="web_search" type="boolean" default={false}>
      Whether to use online search.
    </ParamField>

    <ParamField body="nsfw_checker" type="boolean" default={true}>
      Whether to enable the NSFW checker.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="webhookUrl" type="string">
  URL to receive a webhook when the task completes.
</ParamField>

<ParamField body="metadata" type="object">
  Custom key-value metadata to attach to the task.
</ParamField>

## Pricing

Seedance 2.0 is billed per second by resolution:

| Request type         |         480p |        720p |      1080p |
| -------------------- | -----------: | ----------: | ---------: |
| No video reference   |  \$0.095/sec | \$0.205/sec | \$0.51/sec |
| With video reference | \$0.0575/sec | \$0.125/sec | \$0.31/sec |

When `reference_video_urls` is provided, billing uses input plus output seconds. Image, first/last frame, and audio references without a video reference use the no-video-reference tier.

## Example

```bash theme={null}
curl -X POST https://api.modelhunter.ai/api/v1/seedance/multimodal-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2",
    "input": {
      "prompt": "A cinematic product reveal with smooth camera motion and realistic lighting",
      "first_frame_url": "https://cdn.example.com/first-frame.png",
      "reference_audio_urls": ["https://cdn.example.com/reference-audio.mp3"],
      "generate_audio": false,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "duration": 5
    },
    "metadata": {
      "project": "launch-video"
    }
  }'
```

<ResponseExample>
  ```json 202 theme={null}
  {
    "success": true,
    "data": {
      "id": "task_abc123",
      "status": "pending",
      "type": "multimodal-video",
      "provider": "seedance",
      "model": "bytedance/seedance-2",
      "created_at": "2026-05-15T10:00:00Z",
      "estimated_seconds": 300
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "code": "VALIDATION_ERROR",
      "message": "input.reference_audio_urls must be used with an image or video reference"
    }
  }
  ```
</ResponseExample>