DataEyesAI
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
Official SiteConsoleDocs Home
Getting StartedDeveloper ToolsAI Models APITerms & Policies
  1. Vidu 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. Vidu Video Generation

01-Text-to-Video

Text-to-Video#

Document Version: v1.0.0 | Last Updated: 2026-06-11
This platform fully supports the official Vidu video generation APIs. Requests and responses are transparently proxied with identical parameter semantics.
Generate video from a text prompt.
POST https://studio.dataeyes.ai/vidu/ent/v2/text2video

Request Parameters#

Request Headers#

HeaderRequiredDescription
Content-TypeYesapplication/json
AuthorizationYesBearer {API_KEY}

Request Body#

ParameterTypeRequiredDescription
modelStringYesModel name. Options: viduq3-turbo, viduq3-pro, viduq2, viduq1.
- viduq3-turbo: Faster generation speed compared to viduq3-pro
- viduq3-pro: High-quality audio-video content with better results
- viduq2: Latest model
- viduq1: Clear visuals, smooth transitions, stable camera movement
promptStringYesText prompt. Maximum 5000 characters.
styleStringOptionalStyle. Default general. Options: general, anime.
- general: General style, controllable via prompt
- anime: Anime style
Note: This parameter has no effect on q2 and q3 series models
durationIntOptionalVideo duration (seconds). Default varies by model:
- viduq3-pro, viduq3-turbo: Default 5, range 1–16
- viduq2: Default 5, range 1–10
- viduq1: Default 5, fixed at 5
seedIntOptionalRandom seed. If omitted or set to 0, a random value is used; otherwise the specified value is used.
aspect_ratioStringOptionalAspect ratio. Default 16:9. Options: 16:9, 9:16, 3:4, 4:3, 1:1.
Note: 3:4 and 4:3 are only supported by q2 and q3 series models
resolutionStringOptionalResolution. Default varies by model:
- viduq3-pro, viduq3-turbo (1–16s): Default 720p, options 540p, 720p, 1080p
- viduq2 (1–10s): Default 720p, options 540p, 720p, 1080p
- viduq1 (5s): Default 1080p, fixed at 1080p
movement_amplitudeStringOptionalMovement amplitude. Default auto. Options: auto, small, medium, large.
Note: This parameter has no effect on q2 and q3 series models
audioBoolOptionalWhether to enable audio-video output.
- true: Output video with dialogue and sound effects
- false: Output silent video
Note: Only supported by q3 series models, default is true
bgmBoolOptionalWhether to add background music. Default false.
When set to true, the system automatically selects and adds BGM from a preset library.
Note: Ineffective for q2 model when duration is 9s or 10s; ineffective for q3 series models
off_peakBoolOptionalOff-peak mode. Default false.
- true: Off-peak generation with lower credit consumption; task completes within 48 hours
- false: Immediate generation
watermarkBoolOptionalWhether to add a watermark. Default is no watermark.
wm_positionIntOptionalWatermark position. 1: Top-left, 2: Top-right, 3: Bottom-right (default), 4: Bottom-left
wm_urlStringOptionalCustom watermark image URL. If omitted, the default watermark is used.
payloadStringOptionalPass-through parameter, not processed in any way, used only for data transfer. Maximum 1048576 characters.
meta_dataStringOptionalMetadata identifier, JSON format string, pass-through field. If empty, uses the default metadata identifier generated by Vidu.
callback_urlStringOptionalCallback URL. Vidu sends a POST callback request when the task state changes, with up to 3 retries on failure.

Request Example#


Response Parameters#

FieldTypeDescription
task_idStringTask ID
stateStringProcessing state: created, queueing, processing, success, failed
modelStringModel name used for this call
styleStringStyle parameter used in this call
promptStringPrompt used for this call
durationIntVideo duration
seedIntRandom seed
aspect_ratioStringAspect ratio
resolutionStringResolution
bgmBoolWhether background music is added
movement_amplitudeStringMovement amplitude
payloadStringPass-through parameter
off_peakBoolWhether off-peak mode is used
creditsIntNumber of credits consumed by this call
watermarkBoolWhether a watermark is used
created_atStringTask creation time

Response Example#

{
  "task_id": "{task_id}",
  "state": "created",
  "model": "viduq3-pro",
  "style": "general",
  "prompt": "In an ultra-realistic fashion photography style, an astronaut in a spacesuit walks through the fog.",
  "duration": 5,
  "seed": 123456,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "movement_amplitude": "auto",
  "payload": "",
  "off_peak": false,
  "credits": 8,
  "created_at": "2025-01-01T15:41:31.968916Z"
}
Previous
00-Overview
Next
02-Image-to-Video