Skip to main content

​
Video Generation Live

POST /v1/videos/generations
Generate a video from a text prompt, reference image, or source video. The endpoint queues work for async delivery via callback_url.

​
Request body

ParameterTypeRequiredDescription
modelstringYesVideo model ID. See the model table below.
promptstringConditionalText prompt or editing instruction. Required for text-to-video and supported on transform models that list it.
callback_urlstringNoWebhook URL for async delivery.
secondsnumberNoRequested clip duration. Supported values vary by model.
resolutionstringNoModel-specific output resolution such as 480p, 540p, 580p, 720p, 1080p, or a range where listed.
aspect_ratiostringNoOutput aspect ratio for models that support explicit aspect control.
image_urlstringConditionalRequired for image-to-video models unless the row says the image is optional.
end_image_urlstringNoOptional ending frame for models that support start/end image guidance.
video_urlstringConditionalRequired for video-to-video, video edit, and video extend models.
additional_settingsobjectNoModel-specific provider settings such as seed, negative_prompt, and generate_audio.
enable_fallbackbooleanNoEnable automatic model fallback. Default: true.

​
Models

common means callback_url, additional_settings, and enable_fallback. Model-specific provider knobs such as seed, negative_prompt, and generate_audio are passed in additional_settings. generate_audio is only supported on audio-capable models (those that list it below); setting generate_audio: true adds an audio track and roughly doubles the per-second cost. The cost shown below is the default audio-off rate.
Model IDStatusDisplay nameTypeRequired paramsOptional supported paramsCostETA
t2v-turboLiveText-to-Video TurboText-to-videoprompt, modelcommon + seconds (5, 8), resolution (480p, 720p), aspect_ratio, seed, negative_prompt$0.40~43s
t2v-standardLiveText-to-Video StandardText-to-videoprompt, modelcommon + seconds, aspect_ratio (auto, 16:9, 9:16, 1:1)$1.20~63s
cosmos-predictLiveCosmos PredictText-to-videoprompt, modelcommon + seconds, aspect_ratio$0.80~90s
av-genLiveAV GenText-to-videoprompt, modelcommon + seconds (5, 10, 15), resolution (720p, 1080p)$1.00~84s
ltx-distilledLiveLTX DistilledText-to-videoprompt, modelcommon + seconds, aspect_ratio$0.3996~63s
seedance-2.0-t2vLiveSeedance 2.0 T2VText-to-videoprompt, modelcommon + seconds (5, 10, 15), resolution (480p, 720p, 1080p), aspect_ratio$1.80 default~70s
seedance-2.0-fast-t2vLiveSeedance 2.0 Fast T2VText-to-videoprompt, modelcommon + seconds (5, 10, 15), resolution (480p, 720p, 1080p), aspect_ratio$0.60 default~45s
wan-2.7-t2vLiveWan 2.7 T2VText-to-videoprompt, modelcommon + seconds (5, 10, 15), resolution (720p, 1080p), negative_prompt$1.50 default~70s
wan-2.2-ultra-fast-t2vLiveWan 2.2 Ultra-Fast T2VText-to-videoprompt, modelcommon + seconds (5, 8), resolution (480p, 720p), aspect_ratio, seed, negative_prompt$0.60 default~25s
happyhorse-1.0-t2vLiveHappyHorse 1.0 T2VText-to-videoprompt, modelcommon + seconds (3-15), resolution (720p, 1080p), aspect_ratio (16:9, 9:16, 1:1), seed$0.112-$0.224/sec~70s
i2v-turboLiveImage-to-Video TurboImage-to-videoprompt, model, image_urlcommon + seconds (5, 8), resolution (480p, 720p), aspect_ratio, seed, negative_promptabout $0.11~39s
i2v-standardLiveImage-to-Video StandardImage-to-videoprompt, model, image_urlcommon + seconds, resolution (480p, 720p), aspect_ratio (auto, 16:9, 9:16, 1:1)$0.30-$0.60~38s
i2v-proLiveImage-to-Video ProImage-to-videoprompt, model, image_urlcommon + seconds, resolution (480p, 580p, 720p), aspect_ratio (16:9, 9:16, 1:1), end_image_url$0.04-$0.08/sec~63s
i2v-soraLiveImage-to-Video SoraImage-to-videoprompt, model, image_urlcommon + seconds (4, 8, 12), aspect_ratio (16:9, 9:16, 1:1)about $0.11/sec~146s
i2v-sora-proLiveImage-to-Video Sora ProImage-to-videoprompt, model, image_urlcommon + seconds (4, 8, 12), resolution (720p, 1080p), aspect_ratio (16:9, 9:16, 1:1)$0.30-$0.50/sec~186s
wan-2.6LiveWan 2.6Image-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (720p, 1080p), negative_prompt$0.10-$0.15/sec~84s
wan-2.6-ultraLiveWan 2.6 UltraImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (720p, 1080p), negative_prompt$0.10-$0.15/sec~60s
wan-2.6-flashLiveWan 2.6 FlashImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (720p, 1080p)$0.05-$0.075/sec~45s
wan-2.2-spicyLiveWan 2.2 SpicyImage-to-videoprompt, model, image_urlcommon + seconds (5, 8), resolution (480p, 720p), seed$0.024-$0.048/sec~40s
wan-2.2-ultra-fastLiveWan 2.2 Ultra-Fast I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 8), resolution (480p, 720p), aspect_ratio, seed, negative_prompt$0.008-$0.016/sec~25s
vidu-q3-spicyLiveVidu Q3 SpicyImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (540p, 720p, 1080p)$0.056-$0.128/sec~60s
cosmos-predict-i2vLiveCosmos Predict I2VImage-to-videoprompt, model, image_urlcommon + seconds, aspect_ratioabout $0.50~90s
grok-imagine-videoLiveGrok Imagine VideoImage-to-videoprompt, model, image_urlcommon + seconds (6, 10), resolution (480p, 720p), aspect_ratio (2:3, 3:2, 1:1, 16:9, 9:16)about $0.04/sec~20s
sora-2LiveSora 2Smart-routed videoprompt, modelcommon + optional image_url, seconds (4, 8, 12), aspect_ratio (16:9, 9:16, 1:1)about $0.11/sec~117s
sora-2-proLiveSora 2 ProSmart-routed videoprompt, modelcommon + optional image_url, seconds (4, 8, 12), resolution (720p, 1080p), aspect_ratio (16:9, 9:16, 1:1)$0.30-$0.50/sec~169s
seedance-2.0LiveSeedance 2.0 I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (480p, 720p, 1080p), aspect_ratio$0.12-$0.60/sec~70s
seedance-2.0-fastLiveSeedance 2.0 Fast I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (480p, 720p, 1080p), aspect_ratio$0.10-$0.50/sec~45s
seedance-2.0-spicyLiveSeedance 2.0 Spicy I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (480p, 720p, 1080p), aspect_ratio, generate_audio, end_image_url$0.06-$0.30/sec~70s
seedance-2.0-fast-spicyLiveSeedance 2.0 Fast Spicy I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (480p, 720p, 1080p), aspect_ratio, generate_audio, end_image_url$0.05-$0.25/sec~45s
seedance-v1.5-pro-spicyLiveSeedance v1.5 Pro SpicyImage-to-videoprompt, model, image_urlcommon + seconds (4-12), resolution (480p, 720p, 1080p), aspect_ratio, generate_audio$0.0096-$0.0416/sec~50s
wan-2.7LiveWan 2.7 I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (720p, 1080p), negative_prompt$0.08-$0.12/sec~70s
wan-2.7-proLiveWan 2.7 Pro I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (1080p, 2k, 4k)$0.12-$0.16/sec~70s
wan-2.7-spicyLiveWan 2.7 Spicy I2VImage-to-videoprompt, model, image_urlcommon + seconds (5, 10, 15), resolution (720p, 1080p)$0.10-$0.15/sec~70s
grok-imagine-video-referenceLiveGrok Imagine Reference-to-VideoImage-to-videoprompt, model, image_urlcommon + optional end_image_url, seconds (6, 10), resolution (480p, 720p)about $0.04/sec~25s
happyhorse-1.0LiveHappyHorse 1.0 I2VImage-to-videoprompt, model, image_urlcommon + seconds (3-15), resolution (720p, 1080p), seed; aspect ratio follows the input image$0.112-$0.224/sec~70s
video-to-videoLiveVideo to VideoVideo-to-videoprompt, model, video_urlcommon + seconds, resolution (240p, 360p, 480p, 580p, 720p)$0.04-$0.08/sec~175s
wan-2.6-v2vLiveWan 2.6 V2VVideo-to-videoprompt, model, video_urlcommon + seconds (5, 10), resolution (720p, 1080p)$0.10-$0.15/sec~90s
wan-2.2-spicy-extendLiveWan 2.2 Spicy ExtendVideo extendprompt, model, video_urlcommon + seconds (5, 8), resolution (480p, 720p)$0.024-$0.048/sec~40s
grok-imagine-video-editLiveGrok Imagine EditVideo editprompt, model, video_urlcommon + seconds (1-8), resolution (480p, 720p)$0.06-$0.08/sec~95s
wan-2.7-video-extendLiveWan 2.7 Video ExtendVideo extendprompt, model, video_urlcommon + seconds (5, 10, 15), resolution (720p, 1080p), negative_prompt$0.08-$0.12/sec~70s
grok-imagine-video-extendLiveGrok Imagine Video ExtendVideo extendprompt, model, video_urlcommon + seconds (6, 10)about $0.04/sec~25s
happyhorse-1.0-video-editLiveHappyHorse 1.0 Video EditVideo editprompt, model, video_urlcommon + seconds (3-15), resolution (720p, 1080p), seed, reference images (up to 9, in additional_settings)$0.112-$0.224/sec~70s
happyhorse-1.0-video-extendLiveHappyHorse 1.0 Video ExtendVideo extendprompt, model, video_urlcommon + seconds (3-15), resolution (720p, 1080p), seed$0.112-$0.224/sec~70s
ultimate-video-upscalerLiveUltimate Video UpscalerVideo-to-videoprompt, model, video_urlcommon + seconds, resolution (720p, 1080p, 2k, 4k); output length follows the source clip and prompt is ignored. Billed per second of seconds — set it to your source clip’s duration (max 30)$0.016-$0.064/sec~90s
video-watermark-removerLiveVideo Watermark RemoverVideo-to-videoprompt, model, video_urlcommon + seconds; output length follows the source clip and prompt is ignored. Billed per second of seconds — set it to your source clip’s duration (max 30)$0.008/sec~90s

​
Example request

curl --request POST "https://api.uncensored.com/api/v1/videos/generations" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A cinematic drone shot over a misty mountain range at sunrise",
    "model": "t2v-turbo",
    "seconds": 5,
    "resolution": "720p",
    "callback_url": "https://your-server.com/webhook"
  }'

​
Example response

{
  "id": "vid_abc123",
  "status": "processing",
  "model": "t2v-turbo",
  "created_at": "2025-06-01T12:00:00Z"
}
When processing completes, the result is delivered to your callback_url.

​
Audio on supported models

Audio-capable models (those that list generate_audio in the table above, such as seedance-2.0-spicy) accept generate_audio inside additional_settings. It defaults to off; setting it to true adds an audio track and roughly doubles the per-second cost. 
curl --request POST "https://api.uncensored.com/api/v1/videos/generations" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A neon city street at night with ambient sound",
    "model": "seedance-2.0-spicy",
    "image_url": "https://your-server.com/start.jpg",
    "seconds": 5,
    "resolution": "480p",
    "additional_settings": { "generate_audio": true },
    "callback_url": "https://your-server.com/webhook"
  }'