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

# Text to Video

> Generate a video from text using ByteDance Seedance models via Volcengine Ark.

## 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, lower cost, \$0.010–\$0.049/sec
  * `seedance-1-0-lite-t2v` — Lightweight, cost-effective, \$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="prompt" type="string" required>
      Text description of the video to generate. Supports Chinese and English. Recommended max 500 characters.
    </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`

      Default: `720p` for 1.5 Pro and 1.0 Lite, `1080p` for 1.0 Pro and Pro Fast.
    </ParamField>

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

      `adaptive` auto-selects the best ratio based on the prompt (1.5 Pro only for T2V).
    </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.
    </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. Supports voice, sound effects, and background music. Place dialogue in double quotes for best results.
    </ParamField>

    <ParamField body="return_last_frame" type="boolean" default={false}>
      Return the last frame of the generated video as an image. Useful for chaining multiple videos together.
    </ParamField>

    <ParamField body="draft" type="boolean" default={false}>
      **Seedance 1.5 Pro only.** Enable draft mode for faster generation at lower quality. Useful for rapid iteration.
    </ParamField>

    <ParamField body="service_tier" type="string" default="default">
      Service tier. Options: `default` (standard priority), `flex` (lower priority, may queue longer).
    </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": "text-to-video",
      "provider": "seedance",
      "model": "seedance-1-5-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>