Skip to main content
POST
cURL

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Body

application/json

Video generation parameters

prompt
string
required

Text prompt for video generation

Required string length: 1 - 50000
prompt_expansion_mode
enum<string>
default:balanced
required

How much effort to spend rewriting the prompt before generation. balanced returns in about a second. quality spends up to ~30s on a richer prompt.

Available options:
balanced,
quality
image_url
string<uri>

URL of the image to use as the first frame. When provided, the output aspect ratio follows this image. Generate an image first via POST /api/content/image if needed.

end_image_url
string<uri>

Optional URL of the image to use as the last frame, for first-to-last keyframe generation

duration
integer
default:5

Duration of the generated video, in seconds

Required range: 5 <= x <= 15
resolution
enum<string>
default:768P

The native generation resolution of the video

Available options:
480P,
768P
seed
integer

Random seed. A random seed is selected when omitted.

enable_safety_checker
boolean
default:true

If true, the safety checker will be enabled

sync_mode
boolean
default:false

Return the generated video as base64 instead of a CDN URL

Response

Video generated successfully

videoUrl
string<uri>
required

URL of the generated video