Seedance 2.0 Mini API

Complete API reference for Seedance 2.0 Mini video generation models by ByteDance.

Model Variants

This API supports three model variants:

Quick Comparison

Supported Aspect Ratios

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Resolution Options

Seedance 2.0 Mini Text to Video

Endpoint

POST /api/v1/video/task

Request Parameters

Required

Optional

Example Request

javascriptCopy
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Image to Video

Request Parameters

Required

Optional

Example Request

javascriptCopy
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Reference to Video

Request Parameters

Required

Reference Media

Every request must include at least one image or video. Submit 1-9 images when using image references. The images array may be omitted or empty only when the videos array contains at least one reference video. Audio-only requests are not supported.

@ (AT) Reference Placeholders

The @ (AT) reference feature links reference media to the prompt through numbered <<<...>>> placeholders. Numbering starts at 1 independently for each media type and follows the order of the corresponding array:

Each placeholder must point to an item that exists in its corresponding array.

Optional

Reference Video Pricing

Seedance V2.0 Mini Reference-to-Video follows the same resolution-based, per-second billing structure as the other Seedance 2.0 reference variants. When the videos array contains at least one reference video, the total generation charge is multiplied by 2. This multiplier is applied once, regardless of the number or duration of the uploaded reference videos.

Example Request

javascriptCopy
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Response Format

Initial Response

All models return a task_id for polling:

jsonCopy
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Polling Response

Poll GET /api/v1/video/{taskId} to check status:

jsonCopy
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Status Values

• submitted: Task accepted and waiting to be processed
• processing: Video generation in progress
• succeed: Video generation completed
• failed: Video generation failed

Processing Time

Typical processing time is 2-6 minutes depending on duration and resolution.

Poll every 5-10 seconds to check status.

Best Practices

1. Describe Motion Clearly: Include specific movement descriptions in prompts
2. Resolution Selection: Use 480p for faster processing, 720p for higher quality
3. Audio Enhancement: Keep sound enabled for more immersive video experiences
4. Image to Video: Provide a clear first frame via image_url; use image_end_url when you need controlled start and end frames
5. Reference Media: Use supported image, video, and audio references, and ensure at least one image or video is included
6. Reference Video Pricing: Any Reference-to-Video request containing at least one reference video is charged at 2x, regardless of the number or duration of the uploaded videos
7. Seed Parameter: Do not send seed; Seedance 2.0 Mini models do not support it