curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "alibaba/wan-3.0/text-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"resolution": "720p",
"aspect_ratio": "adaptive",
"duration": 5,
"audio": true,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Wan
Wan 3.0 Text to Video
Create video scenes with Wan 3.0, with optional audio and output up to thirty seconds for longer visual sequences.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "alibaba/wan-3.0/text-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"resolution": "720p",
"aspect_ratio": "adaptive",
"duration": 5,
"audio": true,
"enable_safety_checker": true
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Wan 3.0 Text to Video
Create video scenes with Wan 3.0, with optional audio and output up to thirty seconds for longer visual sequences.Available Models
- alibaba/wan-3.0/text-to-video - Generate video scenes from text prompts.
Duration Options
- 2-30 seconds - Set
durationas an integer. Default: 5 seconds.
Key Features
- Generate video scenes from text prompts.
- Choose from
480p,720p,1080poutput resolutions. - Control audio generation with
audio; it defaults totrue.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place the parameters below inside input.
Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.
Prompt
prompt: Required. Describe the scene and desired motion.- The prompt must not be blank when supplied. Maximum length: 20,000 characters.
Resolution
resolution:480p,720p,1080p. Default:720p.
Aspect Ratio
aspect_ratio:adaptive,16:9,4:3,1:1,3:4,9:16. Default:adaptive.
Audio
audio: Set totrueto enable generated audio, orfalseto disable it. Default:true.
Seed
seedis optional. Supply an integer from0to2147483647.
Safety Checker
enable_safety_checkeris optional. Set it totrueorfalseto control safety checking. Default:true.
Pricing
Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.
Vidgo public model ID. Must be alibaba/wan-3.0/text-to-video.
Available options:
alibaba/wan-3.0/text-to-video Example:
"alibaba/wan-3.0/text-to-video"
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.