DataEyesAI
Official SiteConsoleDocs HomeGetting StartedDeveloper ToolsAI Models API
Terms & Policies
Official SiteConsoleDocs HomeGetting StartedDeveloper ToolsAI Models API
Terms & Policies
  1. Seedance Video Generation
  • 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
  1. Seedance Video Generation

02-Query-Video-Generation-Task

Retrieve a Video Generation Task#

Returns the status and result of one task. Tasks created in the last 7 days can be retrieved.
GET https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id}
{id} is the task ID returned by Create a task.

Request example#

Response examples#

Succeeded (video_url truncated):
{
  "id": "cgt-20261111130737-3kali",
  "model": "doubao-seedance-2-5-260628",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-5/…/cgt-20261111130737-3kali.mp4?…"
  },
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "framespersecond": 24,
  "generate_audio": false,
  "output_format": "mp4",
  "draft": false,
  "seed": 9532,
  "priority": 0,
  "service_tier": "default",
  "execution_expires_after": 172800,
  "usage": { "completion_tokens": 86867, "total_tokens": 86867 },
  "created_at": 1794373663,
  "updated_at": 1794373820
}
Failed:
{
  "id": "cgt-20261110100047-ve01s",
  "status": "failed",
  "error": {
    "code": "400",
    "message": "the parameter duration specified in the request is not valid for model doubao-seedance-2-5 in t2v; received: \"31\""
  },
  "created_at": 1794304848,
  "updated_at": 1794304848
}
model is the model version that actually ran and may differ from the model name in the request.

Response fields#

FieldTypeDescription
idstringTask ID
modelstringModel version that ran
statusstringqueued, running, succeeded, failed, cancelled, expired
errorobjectReturned on failure, with code and message
content.video_urlstringVideo download URL, valid for 24 hours; save it promptly
content.last_frame_urlstringLast-frame image URL; returned only when return_last_frame: true was set
resolution / ratiostringActual output resolution and aspect ratio
durationintegerDuration in seconds, computed as total frames ÷ 24 rounded down; may differ slightly from the actual length
framespersecondintegerFrame rate
generate_audiobooleanWhether the video has synchronized audio
output_formatstringOutput format; 2.5 only
draftbooleanWhether the task is a draft; 2.5 only
seedintegerRandom seed used
priority / service_tier / execution_expires_after / safety_identifier / tools—Same as set at creation
usage.completion_tokensintegerTokens used to generate the video; billing is based on this
usage.tool_usage.web_searchintegerNumber of web searches (when web_search is enabled)
created_at / updated_atintegerCreation and update time (Unix seconds)
TIP
Poll every 10 seconds or more. You can also pass callback_url at creation to receive a push when the task status changes.
Previous
01-Create-Video-Generation-Task
Next
03-Query-Video-Generation-Task-List