curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "google/veo3.1/image-to-video",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail.",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"sound": true
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Google
Veo 3.1 Official Image to Video
Generate motion from an image or connect opening and closing frames with Veo 3.1, with optional sound and output up to 4K.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "google/veo3.1/image-to-video",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail.",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p",
"sound": true
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Veo 3.1 Official Image to Video
Generate motion from an image or connect opening and closing frames with Veo 3.1, with optional sound and output up to 4K.Available Models
- google/veo3.1/image-to-video - Generate video from image input.
Duration Options
- 4, 6, 8 seconds - Set
durationto one of these values. Default: 8 seconds.
Key Features
- Generate motion from one starting image, or connect two images as the first and last frames.
- Choose from
720p,1080p,4koutput resolutions. - Control audio generation with
sound; it defaults totrue.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place the parameters below inside input.
Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.
Prompt
prompt: Required. Describe the scene and desired motion.- The prompt must not be blank when supplied.
Image URLs
image_urls: Required. Provide 1-2 image URLs.- One image is used as the starting frame.
- With two images, list the starting frame first and the ending frame second.
- Images must be publicly accessible and directly downloadable.
Generation Type
- Omit
generation_typewhen supplying one image. - With two images,
generation_typedefaults toframe. - If you explicitly set
generation_type: "frame", exactly two images are required.
Resolution
resolution:720p,1080p,4k. Default:720p.
Aspect Ratio
aspect_ratio:auto,16:9,9:16. Default:16:9.
Audio
sound: Set totrueto enable generated audio, orfalseto disable it. Default:true.
Pricing
Pricing depends on the selected model and applicable output settings. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.
Vidgo public model ID. Must be google/veo3.1/image-to-video.
Available options:
google/veo3.1/image-to-video Example:
"google/veo3.1/image-to-video"
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.