> ## 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.

# Image to Video

> Animate an image into a video using ByteDance Seedance models via Volcengine Ark. Supports first frame, first+last frame, and reference image modes.

## Body Parameters

<ParamField body="model" type="string" required>
  Seedance model. Options:

  * `seedance-1-5-pro` — Latest flagship, audio-visual generation, \$0.012–\$0.116/sec
  * `seedance-1-0-pro` — Multi-shot narrative, cinematic quality, \$0.024–\$0.122/sec
  * `seedance-1-0-pro-fast` — 3x faster (first frame only), \$0.010–\$0.049/sec
  * `seedance-1-0-lite-i2v` — Lightweight, supports reference images, \$0.017–\$0.088/sec

  Pricing varies by resolution (480p/720p/1080p). Seedance 1.5 Pro pricing also depends on whether audio generation is enabled.
</ParamField>

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

  <Expandable title="properties">
    <ParamField body="image" type="string" required>
      First frame image. Accepts a URL or base64-encoded data URI (`data:image/png;base64,...`).

      **Image requirements:**

      * Formats: jpeg, png, webp, bmp, tiff, gif (1.5 Pro also supports heic, heif)
      * Aspect ratio (width/height): 0.4 to 2.5
      * Dimensions: 300px to 6000px per side
      * Max size: 30 MB
    </ParamField>

    <ParamField body="last_image" type="string">
      Last frame image for first+last frame mode. Same format and requirements as `image`.

      **Supported models:** 1.5 Pro, 1.0 Pro, 1.0 Lite I2V.

      The first and last frame images can be the same. If aspect ratios differ, the last frame is auto-cropped to match the first.
    </ParamField>

    <ParamField body="reference_images" type="string[]">
      Reference images for reference-image mode (1-4 images). **Seedance 1.0 Lite I2V only.**

      Use `[图1]`, `[图2]` etc. in the prompt to reference specific images for better results.
    </ParamField>

    <ParamField body="prompt" type="string">
      Text description to guide the video generation. Supports Chinese and English.
    </ParamField>

    <ParamField body="duration" type="number" required>
      Video length in seconds.

      * **1.0 series**: integer from `2` to `12`
      * **1.5 Pro**: integer from `4` to `12`
    </ParamField>

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

      Note: 1.0 Lite I2V reference image mode does not support `1080p`.
    </ParamField>

    <ParamField body="ratio" type="string" default="adaptive">
      Aspect ratio. Options: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive`

      Default is `adaptive` for I2V (matches first frame). Reference image mode does not support `adaptive`.
    </ParamField>

    <ParamField body="seed" type="number" default={-1}>
      Random seed for reproducibility. Range: `-1` to `4294967295`. `-1` means random.
    </ParamField>

    <ParamField body="camera_fixed" type="boolean" default={false}>
      Whether to fix the camera position. Not supported in reference image mode.
    </ParamField>

    <ParamField body="watermark" type="boolean" default={false}>
      Whether to add a watermark to the video.
    </ParamField>

    <ParamField body="generate_audio" type="boolean" default={true}>
      **Seedance 1.5 Pro only.** Generate synchronized audio with the video.
    </ParamField>

    <ParamField body="return_last_frame" type="boolean" default={false}>
      Return the last frame of the generated video. Useful for chaining continuous videos.
    </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>

<ResponseExample>
  ```json 202 theme={null}
  {
    "success": true,
    "data": {
      "id": "task_abc123",
      "status": "pending",
      "type": "image-to-video",
      "provider": "seedance",
      "model": "seedance-1-0-pro",
      "created_at": "2026-01-15T10:00:00Z",
      "estimated_seconds": 40
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "code": "VALIDATION_ERROR",
      "message": "Invalid request parameters"
    }
  }
  ```
</ResponseExample>