Image to Video Options
Learn how to control Image to Video generation.
Prompt
The Image to Video API accepts text prompts to define the result. Prompts can be generated automatically using Autoprompt AI or provided manually.
Autoprompt AI: Automatic prompt generation
Autoprompt AI analyzes the input product image and generates a text prompt tailored to create a contextually relevant video. This is useful for automating image to video generation, especially with large batches of images.
How to use it: Set the generate parameter to true within the prompt object in the options section of your API request.
{
"options": {
"prompt": {
"generate": true
}
}
}You can influence Autoprompt AI by providing guidelines:
{
"options": {
"prompt": {
"generate": true,
"guidelines": "zoom out, glitter particles"
}
}
}Custom prompts: Manual control
For even more precise control over the animation and visual elements, provide your own prompt. Custom prompts must be between 3 and 5000 characters.
Example:
Sound
Generated videos include an audio track. The video model creates sound together with the visuals: ambience, sound effects, and speech when the prompt calls for them. Audio generation cannot be disabled at the model level, and every output file contains an audio stream.
Default behavior with Autoprompt AI
When you use automatic prompt generation ("prompt": {"generate": true}), Autoprompt keeps audio to a near-silent minimum unless your guidelines ask for sound. To get a rich sound layer, describe it in the guidelines, for example: "slow push-in with a soft fabric rustle" or "she says: this serum changed my routine".
Minimizing sound in custom prompts
If you provide your own prompt and it says nothing about audio, the model improvises its own sound, which may include music or speech. To keep a clip quiet, append this to your prompt:
This reliably minimizes audible content, but it is best effort: it does not guarantee a silent result, and the file still contains an audio track.
Guaranteed silence
For guaranteed-silent output, remove the audio stream after downloading the video:
This copies the video stream without re-encoding, so it's lossless and takes a fraction of a second per clip.
Generating silent videos at scale? We can handle audio stripping inside a managed pipeline as part of an enterprise plan. [Contact us →]
Duration
The duration parameter controls how long the generated video will be. It can be set to 5 seconds or 10 seconds.
Possible values
prompt
string or object
3 - 5000
is required
duration
integer
5, 10
5
Last updated
