Veo 3.1 Text-to-Video API

veo3.1/text-to-video

Generate an 8-second video from a text prompt. Direct the subject, action, setting, camera movement, lighting, and framing, then choose 720p, 1080p, or 4K output.

Input

Prompt

238/10,000

Duration

Fixed 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 eight-second shot inside a quiet botanical glasshouse during a sudden rain shower. The camera glides slowly at leaf height past broad wet leaves while droplets strike the glass roof, merge into rivulets, and cast moving reflections across the stone path. Keep the plant geometry stable, water motion physically believable, and the depth transition smooth from foreground leaves to the distant iron doorway. Natural overcast light only. No cuts, no people, no readable text, no logos, no brands, no products, no advertising, no watermark.

One continuous eight-second documentary shot in a quiet pottery studio. An adult potter's two clay-covered hands steadily raise one centered cylinder of wet earthen clay on a turning wheel, narrowing the neck without changing the amount of clay. The camera makes a restrained half-orbit from a medium close view, keeping both hands anatomically consistent and the clay deformation continuous. Soft north-window light reveals water sheen and fingerprints. No cuts, no face, no extra hands, no readable text, no logos, no brands, no products, no advertising, no watermark.

One continuous vertical eight-second shot on a quiet covered railway platform at blue hour. A fictional adult traveler in a charcoal coat stands beside a bench. A brief gust lifts a rust-red scarf; the traveler turns once, catches it against the chest, and becomes still. The camera advances slowly from full-body to medium framing. Keep face, clothing, body proportions, cloth motion, rain and platform perspective consistent. No cuts, no crowd, no readable signs, no dialogue 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/text-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/text-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"
  }
}'

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 Text-to-Video API reference

Veo 3.1 Text-to-Video

Veo 3.1 Text-to-Video turns a written scene into one 8-second video. It is the direct workflow when the shot can be defined without source images. This endpoint is the standard Veo 3.1 workflow exposed by Vidgo.

Why Choose This?

Start from a written shotCreate motion without preparing source media; describe the visible scene and camera plan in the prompt.
Use an explicit endpoint contractThe model ID locks this page to text prompt only, 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.
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

Write the sceneDefine the subject, setting, visible action, and the intended progression across one continuous shot.
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

Concept shotsTurn a written visual direction into a short motion concept for review.
Campaign variationsGenerate landscape and portrait treatments from the same creative premise.
PrevisualizationTest staging and camera movement before committing to production.

Pro Tips

Write one coherent shot rather than several unrelated scenes.
Separate subject action, camera movement, and visual treatment into clear clauses.
Describe only details that can be seen in the finished video.

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/text-to-video.