Image to Video API
Animate uploaded images into videos with Buble video models.
Image to Video API
Image-to-video workflows use either reference_to_video or frames_to_video, depending on the selected model.
Mode selection
| Mode | Input field | Use when |
|---|---|---|
reference_to_video | image_urls | The model accepts reference images. |
frames_to_video | start_frame, optional end_frame | The model accepts frame control. |
Example: reference image to video
curl https://buble.ai/api/v1/generations \
-H "Authorization: Bearer $BUBLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/sora-2",
"mode": "reference_to_video",
"prompt": "Animate the reference image into a short cinematic musical scene with expressive performance and smooth camera motion",
"image_urls": ["https://example.com/reference.png"],
"duration": "4s",
"aspect_ratio": "landscape"
}'Example: start frame to video
curl https://buble.ai/api/v1/generations \
-H "Authorization: Bearer $BUBLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling/kling-v3",
"mode": "frames_to_video",
"prompt": "The product rotates slowly while the camera glides around it, dramatic highlights and realistic motion",
"start_frame": "https://example.com/start.png",
"duration": "5s",
"resolution": "std",
"aspect_ratio": "16:9",
"audio": "false"
}'