Skip to main content
POST
Extend Video
Try it out! Use the API playground on the right to test the Extend Video endpoint directly.

Overview

Extend Video uses AI (Veo 3.1) to intelligently continue and extend your videos. Perfect for:
  • Creating longer content from short clips
  • Generating smooth video continuations
  • Extending storytelling sequences
  • Producing extended versions of marketing videos
  • Automating video length optimization
Extensions are generated in segments of 4-8 seconds each. The AI analyzes the last frame of your video and generates a seamless continuation based on your prompt.

Endpoint


Required Fields

string
required
Media ID of the video to extend (as a string)
string
required
Describe how the AI should continue the video (1-2000 characters)Example: “The camera continues to zoom out, revealing a cityscape at sunset with birds flying across the sky”

Optional Fields

string
Custom name for the project (max 100 characters)
number
default:4
Total duration to extend in seconds (4-60 seconds, must be multiple of 4)
  • Minimum: 4 seconds
  • Maximum: 60 seconds
  • Default: 4 seconds
boolean
default:true
Whether to generate audio for the extended portion
string
Webhook URL for status notifications (max 500 characters, must be HTTPS)
object
Custom metadata object (max 5KB JSON)

Request Examples

Basic Video Extension

Extended Duration with Webhook

Multiple Extensions


Response


Webhook Notification

When your extended video is ready, we’ll POST to your webhook URL (if configured):
Webhook Payload

How It Works

1

Upload Source Video

Provide your source video that you want to extend
2

AI Analysis

Veo 3.1 analyzes the last frame and video motion patterns
3

Generate Extensions

AI generates extension segments (8 seconds each) based on your prompt
4

Seamless Concatenation

All segments are seamlessly concatenated with the source video
5

Final Output

Receive your extended video with smooth transitions

Best Practices

Clear Prompts

Describe the continuation clearly and specifically for best results

Match Style

Reference the visual style of your source video in the prompt

Realistic Durations

Start with 8-16 seconds to ensure quality, then scale up

Audio Consistency

Enable generateAudio for better continuity with the source

Prompt Writing Tips

Good Prompts

✅ “The camera continues to pan right, revealing a mountain range at golden hour with soft clouds drifting across the sky” ✅ “The dancer spins gracefully as the lighting shifts from warm orange to cool blue” ✅ “The product rotates smoothly on the pedestal while particles float upward in the background”

Avoid

❌ “Continue the video” (too vague) ❌ “Make it longer” (no direction) ❌ “Add random stuff” (unclear intent)

Error Handling


Processing Time

Extension processing time varies based on:
  • Target Duration: Longer extensions take more time (each 8-second segment ~2-3 minutes)
  • Audio Generation: Enabling audio adds processing time
  • Queue Load: Peak times may have longer waits
Typical processing times:
  • 8 seconds: 2-3 minutes
  • 16 seconds: 4-6 minutes
  • 32 seconds: 8-12 minutes
  • 60 seconds: 15-20 minutes

Next Steps

List Videos

View all your created videos

Video Details

Check your video processing status

Webhooks Guide

Learn how to handle webhook notifications

Examples

See more extend video examples

Authorizations

x-api-key
string
header
required

Body

application/json
media
string
required

Media ID from uploaded video

prompt
string
required

Describe how the AI should continue the video

Required string length: 1 - 2000
targetDuration
number
default:4

Total duration to extend in seconds (must be multiple of 4)

Required range: 4 <= x <= 60
generateAudio
boolean
default:true

Whether to generate audio for the extended portion

name
string

Custom name for the project

Maximum string length: 100
webhook
string

HTTPS URL for status notifications (max 500 characters)

Maximum string length: 500
metadata
object

Custom metadata object (max 5KB)

Response

Extend Video created successfully

success
boolean
data
object