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

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