Create Video Generation Task#

Version: v1.0.0 | Last Updated: 2026-06-11

This platform fully supports the Doubao Seedance series video generation API. Requests and responses are transparently proxied, and all parameter semantics remain consistent with the official API.

POST https://platform.dataeyes.ai/seedance/api/v3/contents/generations/tasks

Model Capabilities#

Supported Content Combinations#

Request Body Parameters#

Top-Level Parameters#

Generation Parameters#

Parameter Upgrade Note

The recommended approach is to pass generation parameters as top-level fields in the request body (the "new way"). The legacy approach of embedding parameters in the text prompt via a --params {...} suffix (the "old way") is still supported for backward compatibility but is discouraged for new integrations.

New way (recommended):

{
  "model": "seedance-2.0",
  "content": [{"type": "text", "text": "A cat walking on the beach"}],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}

Old way (legacy, still supported):

{
  "model": "seedance-2.0",
  "content": [{"type": "text", "text": "A cat walking on the beach --params {\"resolution\":\"720p\",\"ratio\":\"16:9\",\"duration\":5}"}]
}

When both are present, the top-level body parameters take precedence.

Content Objects#

Important: The role field is specified at the content object level (i.e., content[].role), NOT nested inside image_url, video_url, or audio_url.

Text Content#

{
  "type": "text",
  "text": "A golden retriever running through a sunflower field at sunset, cinematic lighting"
}

Image Content#

{
  "type": "image_url",
  "image_url": {
    "url": "https://example.com/reference.jpg"
  },
  "role": "first_frame"
}

Video Content#

{
  "type": "video_url",
  "video_url": {
    "url": "https://example.com/reference.mp4"
  },
  "role": "reference_video"
}

Audio Content#

{
  "type": "audio_url",
  "audio_url": {
    "url": "https://example.com/reference.mp3"
  },
  "role": "reference_audio"
}

Draft Task Content#

{
  "type": "draft_task",
  "draft_task": {
    "id": "draft_task_abc123"
  }
}

Input Requirements#

Image Requirements#

Video Requirements#

Audio Requirements#

Resolution & Pixel Dimensions#

Note: Pixel dimensions may not exactly match standard broadcast resolutions due to model architecture constraints (e.g., divisibility requirements). The values above are the actual output dimensions produced by each model series.

Request Examples#

Text-to-Video (T2V)#

Image-to-Video (First Frame)#

Image-to-Video (First + Last Frame)#

Response#

{
  "id": "task_abc123def456"
}