Video
Veo 3.1 Lite video
Google Veo 3.1 Lite — 8s. Text-only. 720p/1080p/4K.
Category: Create · veo-3-1-lite
Capabilities
What this model supports, straight from the schema — no pricing, no infrastructure detail.
| Capability | Value |
|---|---|
video_edit Video edit | — |
text_to_video Text-to-video | Yes |
image_to_video Image-to-video | — |
max_prompt_length Max prompt length | 1000 |
reference_to_video Reference-to-video | — |
Parameters
Fields accepted in params (or first-class, where applicable) for POST /generations.
| Name | Label | Type | Required | Default | Options | Min / Max |
|---|---|---|---|---|---|---|
prompt | Prompt | textarea | Required | — | — | — |
duration | Duration | select | Required | 8 | — | — |
aspect_ratio | Aspect ratio | select | Optional | 16:9 | 16:9 · 9:16 | — |
resolution | Resolution | select | Optional | 720p | 720p · 1080p · 4k | — |
Example request
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3-1-lite",
"prompt": "a neon crab on a beach at sunset, cinematic style",
"params": {
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p"
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "veo-3-1-lite",
"prompt": "a neon crab on a beach at sunset, cinematic style",
"params": {
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p"
}
}),
});
const { data } = await res.json();
Example response
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "veo-3-1-lite",
"type": "video",
"status": "completed",
"credits_charged": 40,
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
The job's real cost is returned as credits_charged on the completed response — check GET /balance for the account balance.
Common errors for this job type:
insufficient_credits | Account balance can't cover the job cost. |
content_policy_violation | Prompt or media rejected by content policy. |
generation_timeout | The job exceeded the maximum processing time. |
rate_limited | Too many requests per minute. |
invalid_input | A required parameter is missing or outside the model's schema. |
generation_failed | Generic processing failure. |