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:
{
"options": {
"prompt": "The camera slowly rotates left to right around the burger with natural and realistic motion. Steam rises gently from the top, drifting upward. Bacon edges shift slightly from the heat. Melted cheese softens and begins to drip slowly. A thick drop of sauce slides down the side. The grilled patty glistens as it turns, showing juicy texture. Lettuce and tomato stay fresh and still. The bun gives off a soft heat shimmer. As the camera moves, the full burger looks hot, fresh, and ready to eat. The background shifts gently with it, keeping the burger centered. Soft, out-of-focus lighting moves across the backdrop, creating a rich, appetizing atmosphere."
}
}
Negative prompt
The negative prompt is a parameter that specifies what you don't want to see on the generated video. When specified, it tells the generation process not to include things in the video that match a given text. The negative_prompt
must be between 3 and 5000 characters.
{
"options": {
"prompt": {"generate": true},
"negative_prompt": "blur, distort, and low quality"
}
}
Duration
The duration parameter controls how long the generated video will be. It can be set to 5 seconds or 10 seconds.
{
"options": {
"prompt": {"generate": true},
"duration": 5
}
}
Guidance scale
The guidance scale controls how closely the generated video should match your prompt. You may adjust this scale to gain more control over the output.
Note that adjusting this scale may affect quality.
{
"options": {
"prompt": {"generate": true},
"guidance_scale": 0.5
}
}
Possible values
prompt
string or object
3 - 5000
is required
negative_prompt
string
3 - 5000
duration
integer
5
, 10
5
guidance_scale
float
0.0 - 1.0
0.5
Last updated