Sign in
Videos

Generate Video (Async)

Generate a video asynchronously. Supports two modes:

Image-to-Video (i2v): Provide an imageUrl and a category to animate an existing image with a specific motion/position. You must also provide a videoPath for the output location. Poll GET /api/v1/videos/get?videoId={id} for status.

Text-to-Video (t2v): Provide a character_id and a prompt — the system generates a starting image from the character and animates it automatically. Poll GET /api/v1/jobs/{job_id}/status for status.

post/api/v1/videos/create

Request body

promptstring required

Description of the video content or motion to generate.

imageUrlstring uri

Image-to-Video mode. URL of the source image to animate. Required for i2v mode.

category'blowjob' | 'pov_blowjob' | 'cowgirl' | 'pov_cowgirl' | 'reverse_cowgirl' | 'pov_reverse_cowgirl' | 'pov_missionary' | 'doggy' | 'pov_doggy' | 'cunnilingus' | 'handjob' | 'pov_handjob' | 'foot_job' | 'pov_foot_job' | 'tit_job' | 'standing_up_sex_from_behind'

Image-to-Video mode. Motion/position category for the video. Determines what kind of motion is applied to the source image. Required for i2v mode.

videoPathstring

Image-to-Video mode. S3 storage path for the output video (e.g., videos/{customerId}/{timestamp}-5s.mp4). Required for i2v mode.

videoLength5 | 10 | 15

Image-to-Video mode. Video length in seconds. Must be 5, 10, or 15.

character_idstring

Text-to-Video mode. Character identifier. The system generates a starting image from the character and animates it.

image_urlstring uri

Text-to-Video mode. Alternative to character_id — provide your own source image. The system will animate it based on the prompt with automatic action detection.

prompt_enhancementboolean

Text-to-Video mode. When enabled, the system enhances your prompt using AI to improve video quality and motion. Enabled by default.

length5 | 10 | 15

Text-to-Video mode. Video length in seconds. Must be 5, 10, or 15.

Response

Video generation job accepted (Image-to-Video mode)

idstring

Video job ID. Poll status with GET /api/v1/videos/get?videoId={id}

status'GENERATING'

Initial job status

Changes

No recorded changes to this endpoint across all 1 revision of this API.