Endpoint
POST /v3/universal-ai/async (async)
Model string pattern: video/generation_async/{provider}[/{model}]
Input
| Field | Type | Required | Description |
|---|---|---|---|
| text | string | Yes | Text prompt describing the content and style of the video to generate |
| file | file_input | No | Initial keyframe image (JPEG or PNG) file ID from /v3/upload or direct file URL |
| duration | int | No | Length of the generated video in seconds |
| dimension | string | No | Video resolution in ‘widthxheight’ format (e.g., ‘1280x720’) |
| seed | int | No | Random seed for generation reproducibility (0 to 2,147,483,646). Omit for varied output. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
| video | string | Yes | |
| video_resource_url | string | Yes | |
| usage | dict | No |
Available Providers
| Provider | Model String | Price |
|---|---|---|
| amazon (amazon.nova-reel-v1:1) | video/generation_async/amazon/amazon.nova-reel-v1:1 | $0.08 per second |
| amazon | video/generation_async/amazon | $0.5 per request |
| bytedance | video/generation_async/bytedance | $0.05 per second |
| bytedance (seedance-1-0-pro-250528) | video/generation_async/bytedance/seedance-1-0-pro-250528 | $2.5 per 1,000,000 tokens |
| bytedance (seedance-1-0-pro-fast-251015) | video/generation_async/bytedance/seedance-1-0-pro-fast-251015 | $0.022 per second |
| bytedance (seedance-1-5-pro-251215) | video/generation_async/bytedance/seedance-1-5-pro-251215 | $1.2 per 1,000,000 tokens |
| bytedance (seedance-2-0-260128) | video/generation_async/bytedance/seedance-2-0-260128 | $0.147 per second |
video/generation_async/google | $3.6 per request | |
| google (veo-3.0-fast-generate-001) | video/generation_async/google/veo-3.0-fast-generate-001 | $0.12 per second |
| google (veo-3.0-generate-001) | video/generation_async/google/veo-3.0-generate-001 | $0.4 per second |
| google (veo-3.1-fast-generate-preview) | video/generation_async/google/veo-3.1-fast-generate-preview | $0.1 per second |
| google (veo-3.1-generate-preview) | video/generation_async/google/veo-3.1-generate-preview | $0.6 per second |
| google (veo-3.1-lite-generate-preview) | video/generation_async/google/veo-3.1-lite-generate-preview | $0.05 per second |
| minimax | video/generation_async/minimax | $0.56 per request |
| minimax (MiniMax-Hailuo-02) | video/generation_async/minimax/MiniMax-Hailuo-02 | $0.28 per request |
| minimax (MiniMax-Hailuo-2.3) | video/generation_async/minimax/MiniMax-Hailuo-2.3 | $0.084 per request |
| minimax (S2V-01) | video/generation_async/minimax/S2V-01 | $0.65 per request |
| minimax (T2V/I2V-01-Director) | video/generation_async/minimax/T2V/I2V-01-Director | $0.43 per request |
| openai | video/generation_async/openai | $5 per request |
| openai (sora-2) | video/generation_async/openai/sora-2 | $0.1 per second |
| openai (sora-2-pro) | video/generation_async/openai/sora-2-pro | $0.3 per second |
| pixverse (c1) | video/generation_async/pixverse/c1 | $0.004 per token |
| pixverse | video/generation_async/pixverse | $0.004 per token |
| pixverse (v5) | video/generation_async/pixverse/v5 | $0.004 per token |
| pixverse (v5.5) | video/generation_async/pixverse/v5.5 | $0.004 per token |
| pixverse (v6) | video/generation_async/pixverse/v6 | $0.004 per token |
Provider Parameters
This subfeature accepts only theprovider_params listed for each provider, and rejects any other with 400 Bad Request. Each entry is a path in the provider’s own request format, lowercased, with nested keys joined by dots: send it as nested objects, in the casing the provider documents.
| Provider | Accepted parameters |
|---|---|
| amazon | texttovideoparams.images.format, texttovideoparams.images.source.bytes, texttovideoparams.text, videogenerationconfig.dimension, videogenerationconfig.fps, videogenerationconfig.seed |
| bytedance | camerafixed, content.image_url.url, duration, ratio, resolution, seed, watermark |
aspectratio, compressionquality, enhanceprompt, generateaudio, negativeprompt, persongeneration, resizemode, seed, video.uri | |
| minimax | fast_pretreatment, first_frame_image, last_frame_image, prompt_optimizer, subject_reference.image |
| openai | input_reference, prompt |
| pixverse | aspect_ratio, duration, generate_audio_switch, generate_multi_clip_switch, img_id, img_ids, lip_sync_tts_content, lip_sync_tts_speaker_id, lip_sync_tts_switch, model, motion_mode, negative_prompt, prompt, quality, seed, sound_effect_content, sound_effect_switch, template_id, water_mark |
| pruna | aspect_ratio, disable_prompt_upsampling, fps, negative_prompt, prompt, prompt_upsampling, seed, strength_negative_prompt, video_prompt, voice, voice_language, voice_prompt |
| xai | aspect_ratio, duration, image.url, prompt |
Quick Start
This is an async feature. The initial response returns a job ID. Poll GET /v3/universal-ai/async/{job_id} until the job completes.
import requests
url = "https://api.edenai.run/v3/universal-ai/async"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"model": "video/generation_async/amazon/amazon.nova-reel-v1:1",
"input": {
"text": "The quick brown fox jumps over the lazy dog."
}
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())
curl -X POST https://api.edenai.run/v3/universal-ai/async \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "video/generation_async/amazon/amazon.nova-reel-v1:1",
"input": {"text": "The quick brown fox jumps over the lazy dog."}
}'