DataEyesAI
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
  1. Seedance Video Generation
  • Documentation
    • Getting Started
      • Welcome to DataEyesAI
      • Quickstart
      • API Keys and Authentication
      • Base URL and SDKs
      • Models, Groups, and Pricing
    • Developer Tool Integration
      • Claude Code
      • Claude Code for VS Code
      • Codex
      • OpenClaw
      • OpenCode
      • Cline
      • Gemini CLI
      • Grok CLI
      • n8n
      • AutoClaw
      • Other tools
      • Claude Code 400 troubleshooting
    • AI Models API
      • API Overview
      • Chat Completions
      • Responses
      • Messages (Claude)
      • Gemini (generateContent)
      • Embeddings
      • Image Models
        • Images
        • Gemini Image Generation
        • Grok Imagine Image
      • Midjourney format
        • Midjourney API Reference
        • Task query interface
        • Upload image
        • Get seed (Seed)
        • Submit Imagine task
        • Query tasks based on ID list
        • FaceSwap
        • Execute Action operation
        • /mj/submit/blend
        • Submit Describe task
        • Submit Modal
        • Refresh link
        • Edit image
        • Query task status by task ID
        • Get the seed of the task image
      • Video Model
        • FLUX Video Generation (flux-3-video)
        • Grok Video Generation
          • 00-Overview
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Reference-to-Video
          • 04-Video-Editing
          • 05-Video-Extension
        • Seedance Video Generation
          • 00-Overview
          • 01-Create-Video-Generation-Task
          • 02-Query-Video-Generation-Task
          • 03-Query-Video-Generation-Task-List
          • 04-Cancel-or-Delete-Task
          • Seedance Private Asset Library API Documentation
        • MiniMax-H3 Video Generation
          • 00-Overview
          • 01-Create-Video-Generation
          • 02-Create-Video-Regeneration
          • 03-Create-H3-Context-IR
          • 04-Query-Task
          • 05-List-Tasks
          • 06-Cancel-or-Delete-Task
        • Hailuo Video Generation
          • 00-Overview
          • 01-Text-to-Video-T2V
          • 02-Image-to-Video-I2V
          • 03-First-Last-Frame-FL2V
          • 04-Subject-Reference-S2V
          • 05-Query-Task-Status
          • 06-Video-Download
          • 99-Appendix-Camera-Movement-and-Webhooks
        • Jimeng Video Generation
          • 00-Overview
          • 01-3.0-Pro-Video-Generation
          • 02-720P-Text-to-Video
          • 03-720P-Image-to-Video-First-Frame
          • 04-720P-Image-to-Video-Start-End-Frame
          • 05-720P-Image-to-Video-Camera
          • 06-1080P-Text-to-Video
          • 07-1080P-Image-to-Video-First-Frame
          • 08-1080P-Image-to-Video-Start-End-Frame
          • 09-Error-Codes
        • Kling AI Video Generation
          • 00-Overview
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Omni-Video
          • 04-Multi-Image-to-Video
          • 05-Motion-Control
          • 06-Multi-Elements
          • 07-Video-Extension
          • 08-Lip-Sync
          • 09-Avatar
          • 10-Text-to-Audio
          • 11-Video-to-Audio
          • 12-TTS
          • 13-Custom-Voices
          • 14-Image-Recognition
          • 15-Element-Management
          • 16-Video-Effects
          • 17-Kling-4.0-Video-Generation
        • Vidu Video Generation
          • 00-Overview
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Reference-to-Video
          • 04-Start-End-Frame
          • 05-Multi-Frame
          • 06-Scene-Template
          • 07-Template-Story
          • 08-Query-Tasks
        • HappyHorse
          • HappyHorse Text-to-Video
          • HappyHorse Image-to-Video (First Frame)
          • HappyHorse Reference-to-Video
          • HappyHorse Video Editing
        • Wan Video Generation
          • 00-Overview.md
          • 01-Text-to-Video
          • 02-Image-to-Video
          • 03-Reference-to-Video
          • 04-Video-Editing
          • 05-First-Last-Frame-to-Video
          • 06-Motion-Transfer-and-Character-Swap
          • 07-Digital-Human-Video
          • 08-VACE-Video-Editing
          • 09-Query-Task
      • Audio API
        • Audio API
        • Gemini TTS API
        • Google DeepMind Lyria API
        • Elevenlabs Speech to Text API Reference
    • Search / Reader Product
      • Search & Reader
      • Web Search
      • Search and Read
      • Video Search
      • Web Reader
      • Document Parsing
      • Trending
      • Weather
      • All City ID
    • Advanced & System API
      • FAQ
      • System interface
        • API Key & Quota Query API
        • API Key Management API
      • API Reference​​
        • Error Codes
        • Rate Limits and Billing Rules
      • List models
        • Models
  • Terms & Policies
    • DataEyesAI API Terms of Service
    • DataEyesAI Legal Notice and Privacy Policy
    • DataEyesAI Paid Services Agreement
    • Automatic Renewal Service Rules
  1. Seedance Video Generation

01-Create-Video-Generation-Task

Create a Video Generation Task#

Creates an asynchronous video generation task from text, images, videos, and audio passed in the content array, and returns the task id.
POST https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks

Quick example (text to video)#

Response:
{ "id": "cgt-20261111150751-sxe7w" }
Use the id to poll Retrieve a task. Task IDs are valid for 7 days (draft tasks: 14 days).

Request parameters#

ParameterTypeRequiredDescription
modelstringYesModel name; see Overview · Models
contentobject[]YesInput content; see "content" below
resolutionstringNo480p, 720p (default), 1080p. 2.0 fast / mini do not support 1080p
ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive (default; chosen from the input)
durationintegerNoDuration in seconds. 2.5: 4–30; 2.0 series: 4–15; -1 lets the model choose (2.5 defaults to -1)
generate_audiobooleanNoGenerate synchronized audio (voices, sound effects, music); default true. false outputs a silent video
watermarkbooleanNoAdd an "AI generated" watermark at the bottom right; default false
return_last_framebooleanNoReturn the last frame as an image (content.last_frame_url); default false. Useful as the first frame of the next clip
draftbooleanNo2.5 only. Draft mode: generate a 480p draft to check the result, then generate the final video; see "Draft mode" below
omni_reference_task_typestringNo2.5 only. Type of a multimodal reference task: auto (default), reference (generate from references), edit (edit a video), extend (extend a video). When set, parameters are validated at submission
output_formatstringNo2.5 only. mp4 (default) or mov
toolsobject[]NoTools, for example [{"type": "web_search"}] to enable web search
priorityintegerNoQueue priority 0–9, default 0; higher runs first
callback_urlstringNoReceives a POST whenever the task status changes, with the same body as the retrieve endpoint
execution_expires_afterintegerNoTask timeout in seconds, 3600–259200, default 172800 (48 hours). The status becomes expired after timeout
safety_identifierstringNoEnd-user identifier (hashing recommended), up to 64 characters
TIP
Duration affects billing. With duration: -1, the actual duration is the duration returned by the retrieve endpoint.

content#

content is an array of objects distinguished by type. role sits alongside image_url / video_url / audio_url, not inside them.
typeFormatrole
text{"type": "text", "text": "prompt"}—
image_url{"type": "image_url", "image_url": {"url": "..."}, "role": "first_frame"}first_frame, last_frame, reference_image
video_url{"type": "video_url", "video_url": {"url": "..."}, "role": "reference_video"}Always reference_video
audio_url{"type": "audio_url", "audio_url": {"url": "..."}, "role": "reference_audio"}Always reference_audio
draft_task{"type": "draft_task", "draft_task": {"id": "draft task ID"}}—
url accepts a public URL, Base64 (data:image/png;base64,..., data:audio/wav;base64,...; not supported for video), or an asset ID (asset://...; see the Private Asset Library).
The three generation modes are mutually exclusive:
Modecontent
Image to video, first frameText (optional) + 1 first_frame image
Image to video, first and last framesText (optional) + 1 first_frame + 1 last_frame image
Multimodal referenceText (optional) + any combination of reference images, videos, and audio. The 2.0 series needs at least 1 image or video; 2.5 accepts audio only
For first-frame and first-and-last-frame tasks, 2.5 follows the first frame's aspect ratio (ratio must be adaptive).

Input requirements#

InputRequirementsCount (2.5)Count (2.0 series)
Imagejpeg, png, webp, bmp, tiff, gif, heic, heif; aspect ratio 0.4–2.5; width and height 300–6000 px; under 30 MB each1–30 reference images1–9 reference images
Videomp4, mov (H.264 / H.265); aspect ratio 0.4–2.5; up to 200 MB each; 24–60 fpsUp to 10; 2–30 s each; 30 s totalUp to 3; 2–15 s each; 15 s total
Audiowav, mp3; up to 15 MB eachUp to 10; 2–30 s each; 30 s totalUp to 3; 2–15 s each; 15 s total
The request body must not exceed 64 MB; use URLs for large files. Input images and videos must not contain real human faces (this also applies to first frames). To use portraits, use authorized assets from the Private Asset Library.

Request examples#

Image to video, first frame#

Image to video, first and last frames#

Multimodal reference (reference image + reference video)#

Draft mode (2.5 only)#

Step 1: generate a draft (480p only):
Step 2: when the draft looks right, generate the final video from the draft task ID:
Step 2 needs only model and draft_task. Some parameters are carried over from the draft and cannot be passed again, such as resolution (passing it returns 400). Draft task IDs are valid for 14 days.

Common errors#

Parameter errors return 400 at submission with the official error message, and are not billed:
Error (excerpt)Cause
the parameter duration specified in the request is not validduration is outside the series' range
InvalidParameter.TaskTypeConstraint ... only supported in the multimodal reference scenarioomni_reference_task_type cannot be set for text-to-video, first-frame, or first-and-last-frame tasks
omni_reference_task_type ... allowed values: auto, reference, edit, extendInvalid omni_reference_task_type value
InputImageSensitiveContentDetected.PrivacyInformationThe input image may contain a real human face
Some errors only appear while the task runs (for example, when the task type inferred from the prompt does not match). The task status is then failed, with the reason in error of the retrieve response.
Previous
00-Overview
Next
02-Query-Video-Generation-Task