Veo 3.1 Image-to-Video API

google/veo3.1/image-to-video

Generate an 8-second transition from exactly two ordered images. The first image defines the opening frame and the second defines the ending frame.

Input

Prompt

238/10,000

Start frame

Upload image

End frame

Upload image

Duration

8sFixed by this endpoint

Resolution

Aspect ratio

Output

Idle

Generated video appears here

Configure the input and run the task. Progress and the finished video will stay in this panel.

Examples

One continuous locked-off shot that moves naturally from the first frame to the second. The copper observatory dome shutters separate slowly and evenly, revealing the dark telescope aperture and a narrow warm interior glow as dawn brightens slightly. Preserve the stone building, dome geometry, mountain silhouette, frost, camera position and composition. Motion should be mechanical, restrained and physically believable. No new objects, no people, no text, no logos, no brands, no products, no advertising, no watermark.

One continuous fixed-camera transition from the first tide-pool frame to the second. A light breeze creates small realistic ripples, then restrained blue bioluminescent points emerge in the water and around the same anemones while twilight deepens. Preserve every rock, the pool boundary, ocean horizon and camera perspective. The illumination grows organically rather than flashing. No added animals, no cuts, no text, no logos, no brands, no products, no advertising, no watermark.

One continuous vertical locked-camera transition from the snowy bridge to the wet thawed bridge. Sunlight gradually warms, snow on the planks settles and melts into reflective water, and occasional droplets fall from the railings while the stream keeps flowing. Preserve the exact bridge, birch trunks, railings, perspective and forest layout. No time-lapse jumps, no people, no text, no logos, no brands, no products, no advertising, no watermark.

REST API

Quick Start

Authenticate, submit the exact model contract, then poll the returned task ID. The complete field reference remains in the API documentation.

Authenticate

Send your Vidgo API key as a Bearer token. Keep the key on the server and never expose it in browser code.

Endpoint: POST https://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer VIDGO_API_KEY

Submit the generation task

Use the exact model ID veo3.1/image-to-video. The submit endpoint returns an asynchronous task ID.

Submit request

curl --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "veo3.1/image-to-video",
  "input": {
    "prompt": "A single continuous shot of a paper boat drifting through a rain-lit city canal at dusk.",
    "duration": 8,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "image_urls": [
      "https://example.com/start-frame.jpg",
      "https://example.com/end-frame.jpg"
    ]
  }
}'

Submit response

{
  "code": 200,
  "data": {
    "task_id": "task-unified-...",
    "status": "not_started"
  }
}

Poll for the result

Request task status with task_id until the task reaches finished or failed.

GET https://api.vidgo.ai/api/generate/status/{task_id}

not_started → running → finished | failed

Full documentation: Veo 3.1 Image-to-Video API reference

Veo 3.1 Image-to-Video

Veo 3.1 Image-to-Video uses exactly two ordered images plus a prompt to create an 8-second transition from a defined start frame to a defined end frame. This endpoint is the standard Veo 3.1 workflow exposed by Vidgo.

Why Choose This?

Control both ends of the shotLock the opening and ending visual states while the prompt directs motion between them.
Use an explicit endpoint contractThe model ID locks this page to exactly 2 ordered image urls, so the form and JSON request stay aligned.
Choose the delivery resolutionUse 720p, 1080p, or 4K output with landscape or portrait framing.
Budget before submissionThe Playground shows the required credits for the selected resolution before the task is sent.

Parameters

Parameter	Requirement	Description
prompt	Required	String. Describe visible content, action, camera direction, lighting, and composition; maximum 10,000 characters.
image_urls	Required	Array of exactly 2 public HTTP(S) image URLs in start-frame, end-frame order.
duration	Optional	Integer. Defaults to 8; this endpoint accepts no other duration. Default`8`
resolution	Optional	String. Select the output resolution; defaults to 720p. Default`720p1080p4k`
aspect_ratio	Optional	String. Select landscape or portrait framing. `16:99:16`

How to Use

Prepare two framesUpload the start frame first and the end frame second; their order changes the generated transition.
Direct the motionDescribe concrete subject movement and camera movement in separate clauses so each instruction has a clear role.
Set the outputKeep duration at 8 seconds, then select resolution and aspect ratio.
Run and track the taskSubmit the request, retain task_id, and poll status until the task is finished or failed.

Pricing

Billing is per generated video and depends on the selected resolution.

Usage	Rate	Details
720p	200 credits	Per successful 8-second video request.
1080p	200 credits	Per successful 8-second video request.
4k	400 credits	Per successful 8-second video request.

Best Use Cases

Product transitionsMove between two approved product compositions while preserving a clear opening and ending.
Before-and-after sequencesConnect two defined visual states in one short generated shot.
Storyboard interpolationUse adjacent storyboard frames to explore motion and timing between planned beats.

Pro Tips

Write one coherent shot rather than several unrelated scenes.
Separate subject action, camera movement, and visual treatment into clear clauses.
Check image order before submitting: first URL is the start frame and second URL is the end frame.

Notes

Generation is asynchronous; keep task_id and stop polling when status reaches finished or failed.
The public model ID for this page is veo3.1/image-to-video.