Seedance 1.5 Pro API

Complete API reference for Seedance 1.5 Pro video generation models.

Model Variants

This API supports two model variants:

Quick Comparison

Supported Aspect Ratios

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

Resolution Options

Seedance 1.5 Pro 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-v1.5-pro-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

Body-only example with optional parameters:

javascriptCopy
{
  model_name: 'seedance-v1.5-pro-text-to-video',
  prompt: 'A golden retriever running through a sunlit meadow',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true,
  camera_fixed: false,
  seed: 42
}

Seedance 1.5 Pro 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-v1.5-pro-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '1080p',
    aspect_ratio: '16:9'
  })
});

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

Body-only example:

javascriptCopy
{
  model_name: 'seedance-v1.5-pro-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly pulls back to reveal the full landscape',
  duration: 6,
  resolution: '1080p',
  aspect_ratio: '16:9',
  sound: true
}

Response Format

Initial Response

Both 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: 2-5 minutes depending on duration and resolution.

Longer videos at 1080p may take up to 8 minutes. Poll every 5-10 seconds to check status.

Best Practices

1. Describe Motion Clearly: Include specific movement descriptions in prompts for more predictable results
2. Resolution Selection: Use 480p or 720p for faster iteration, 1080p for final output
3. Camera Control: Set camera_fixed: true when you want the subject to be the focus without camera drift
4. Aspect Ratio: Match the aspect ratio to your target platform (e.g., 9:16 for mobile, 16:9 for desktop)
5. Reproducibility: Use the seed parameter to reproduce or iterate on a specific generation
6. Image Quality: For image-to-video, use high-resolution, well-lit input images for best results