models

Google: Veo 3.1 Fast

Markdown · JSON

Google: Veo 3.1 Fast

Veo 3.1 Fast is Google’s video model for short text- or image-led scenes with generated sound. Its production profile returns four-, six- or eight-second MP4 clips at 24 fps, with 720p or 1080p output and guided opening or ending frames.

About the model

This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below.

Veo 3.1 Fast is Google’s fast video-generation profile for a short scene described in text or established by an image. It combines the visual shot with generated sound and supports guided opening and ending frames. Use it for developing a scene concept, preparing short creative variations or making a compact audiovisual segment with a clear action and visual direction.

Build the brief around the subject, action and setting. Then add the framing, camera movement, lighting and visual treatment that make the shot useful. An original product brief might show a small ceramic lamp on a wooden desk, with the camera slowly approaching as the light turns on and a quiet switch sound accompanies the action. The subject and visible event describe the picture; the sound direction describes the listening experience.

Write the scene direction in English, as specified by the producer’s prompt profile. Keep the main action proportionate to the clip length and distinguish a camera movement from the subject’s movement. A wide establishing view, a close-up of a texture and a shot following a moving object answer different creative questions. Choose the view that communicates the intended detail rather than combining unrelated camera directions in one short shot.

For an image-led scene, prepare a clear starting image that already establishes the appearance and composition. The motion brief can then concentrate on the event that follows. An ending frame can provide a visual destination for the transition. Keep the important subject details and style coherent between the frames, or describe the intended transformation explicitly. Review the transition itself as well as its opening and final image.

The maker’s production profile supports four-, six- or eight-second clips, landscape 16:9 or portrait 9:16 framing, and up to four video outputs per prompt. Fast output is 720p or 1080p, at 24 frames per second, in MP4 format. The image-led profile accepts JPEG or PNG, lists a maximum input image size of 20 MB and supports 720p/1080p input configurations. Prepare the composition for its intended orientation and keep the input within that image allowance.

Sound can be part of the generated scene. Describe any spoken line, environmental sound or relevant effect with the visible action, identifying the subject that should speak and the event that should make the sound. Keep dialogue short enough for the intended performance and distinguish it from atmosphere or music. Audio generation follows the written scene brief; an audio recording is not among the documented normal inputs for this profile.

The current production profile also lists asset-reference generation and video extension. References guide the appearance of a subject or object, while boundary frames guide the opening and ending composition. Select reference material whose role is clear in the scene rather than treating every image as an interchangeable control. For a continuing clip, choose the separate extension workflow and describe what should happen after the existing action; its input handling is distinct from a new text-led shot.

A negative description can identify content or visual treatments you want to avoid. Keep the main prompt focused on the scene you want and make the exclusions specific to the task. For a product variation, preserve the subject and framing while changing one detail, such as a light direction or material treatment. Retain the settings and reference bundle when comparing results so the creative difference remains clear.

Veo 3.1 Fast and the regular Veo 3.1 profile remain distinct choices. The documented Fast production output is 720p/1080p; the regular profile also lists 4K. Keep the selected edition and its output settings with the artifact instead of treating a Preview identifier or another Veo version as an automatic synonym for this production profile.

The workflow creates a generation operation and exposes the returned video files after completion. Keep every actual output selected for review, together with its brief, source frames and relevant settings. An operation identifier is a record of the generation; the completed MP4 artifact is what can be played and used in the edit. Preserve any supplied content-provenance metadata with the video.

Review the subject’s appearance, requested action, camera treatment and sound across the full clip. Check dialogue intelligibility and the relationship between sound and visible events before using it in a longer composition. The useful result can be a concept shot, a product reveal or a short narrative segment, with later titles, transitions and other editing added in the surrounding production workflow.

Ailoot Ultra · Video POST /v1/videos google/veo-3.1-fast

google/veo-3.1-fast

Google /google/veo-3.1-fast

Overview

Veo 3.1 Fast is Google’s video model for short text- or image-led scenes with generated sound. Its production profile returns four-, six- or eight-second MP4 clips at 24 fps, with 720p or 1080p output and guided opening or ending frames.

Accepted inputs
Text
Results
Video

Available in Ailoot · inputs & methods

Ailoot Ultra · Video POST /v1/videos
Input types
text
Output types
video
Output format
mp4
Output count
Up to 4 outputs
FieldTypeRequirementValues & limitsDefault
FieldmodelTypestringRequirementRequiredValues & limits
google/veo-3.1-fast
Default—
FieldpromptTypestringRequirementRequiredValues & limits
Maximum UTF-8 bytes: 10,000
Non-whitespace required: Yes
Default—
FielddurationTypeintegerRequirementRequiredValues & limits
4, 6, 8
Default—
FieldresolutionTypestringRequirementRequiredValues & limits
720p
Default—
Fieldaspect_ratioTypestringRequirementRequiredValues & limits
16:9, 9:16
Default—
Fieldgenerate_audioTypebooleanRequirementRequiredValues & limits
false, true
Default—
Input material combinations

Text to video · Required: prompt

Method parameters and lifecycle
ParameterContract
Parametercontent_typeContractapplication/json
ParameterrequiredContractmodel, prompt, duration, resolution, aspect_ratio, generate_audio
Parameteradditional_propertiesContractfalse
ParameterparametersContract{"name":"model","type":"string","required":true,"enum":["google/veo-3.1-fast"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]}
Parametermaterial_typesContracttext

Method aliases: /v1/videos/generations, /videos, /videos/generations

Lifecycle: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Keep the complete response and the original returned IDs.

Never resubmit an unknown creation.

Pricing

How the final charge is calculated

The displayed rates estimate the cost before generation. The final charge is calculated from the cost recorded for the original generation. Measured output duration and forecast quantities are not the final billable quantity.

Tariff references do not add request options. Supported parameters are listed for the selected method.

Fast mode
Not specified When fast mode is selected
Flex mode
Not specified When flex mode is selected
Maximum reasoning effort
Not specified When maximum reasoning effort uses the default adjustment

Estimated rates for comparison

Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

ConfigurationRate scheduleForecast quantityGenerate audioResolutionBilling unitBilling conditionsCharge
ConfigurationBase token ratesRate scheduleBase rateForecast quantity—Generate audio—Resolution—Billing unit—Billing conditions—Charge
Input · Input tokens · Estimate for comparison only — / 1K tokens
Output · Output tokens · Estimate for comparison only — / 1K tokens
Input · Cache read · Estimate for comparison only — / 1K tokens
Input · Cache write · Estimate for comparison only — / 1K tokens
Input · Cache write, 1 hour · Estimate for comparison only — / 1K tokens
ConfigurationVideo priceRate schedule—Forecast quantity—Generate audio—Resolution—Billing unitper video secondBilling conditionsaudio: with_audioCharge
Output · Video price · Estimate for comparison only $0.24 per video second
ConfigurationVideo priceRate schedule—Forecast quantity—Generate audio—Resolution—Billing unitper video secondBilling conditionsaudio: with_audio; resolution: 4kCharge
Output · Video price · Estimate for comparison only $0.6 per video second
ConfigurationUltraRate schedule—Forecast quantityRequested configuration; estimate only.Generate audioWith audioResolution720pBilling unitper output video secondBilling conditions—Charge
Output · Estimated output video second · Estimate for comparison only $0.2 per output video second

The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.

ConfigurationVideo priceRate schedule—Forecast quantity—Generate audio—Resolution—Billing unitper video secondBilling conditionsaudio: without_audioCharge
Output · Video price · Estimate for comparison only $0.2 per video second
ConfigurationVideo priceRate schedule—Forecast quantity—Generate audio—Resolution—Billing unitper video secondBilling conditionsaudio: without_audio; resolution: 4kCharge
Output · Video price · Estimate for comparison only $0.5 per video second
ConfigurationUltraRate schedule—Forecast quantityRequested configuration; estimate only.Generate audioWithout audioResolution720pBilling unitper output video secondBilling conditions—Charge
Output · Estimated output video second · Estimate for comparison only $0.16 per output video second

The displayed rate estimates the cost before generation. The final charge is calculated from the cost recorded for the original generation. Physical video duration is not the billable quantity.

ConfigurationEstimated generation costRate schedule—Forecast quantityone generation estimateGenerate audio—Resolution—Billing unit—Billing conditions—Charge
Output · Estimated generation cost · Estimate for comparison only $0.64 estimate before generation

This estimate is not an additional charge or a fixed rate for the completed generation.

Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. How reservation and settlement work →

Reference tariff details

Model-level reference schedules do not change method selection, quotes or charges. Active charges use the selected Ailoot method rates.

Video configuration price references

Prices by configuration

Match each charge to the conditions shown. Use one rate for each set of alternative configurations.

ConfigurationBilling conditionsCharge
ConfigurationVideo priceBilling conditionsaudio: with_audioCharge
Output · Video price $0.24 per video second

Published price reference for the configuration shown. Final charges follow the actual billed configuration.

ConfigurationVideo priceBilling conditionsaudio: with_audio; resolution: 4kCharge
Output · Video price $0.6 per video second

Published price reference for the configuration shown. Final charges follow the actual billed configuration.

ConfigurationVideo priceBilling conditionsaudio: without_audioCharge
Output · Video price $0.2 per video second

Published price reference for the configuration shown. Final charges follow the actual billed configuration.

ConfigurationVideo priceBilling conditionsaudio: with_audio; resolution: 720pCharge
Output · Video price $0.2 per video second

Published price reference for the configuration shown. Final charges follow the actual billed configuration.

ConfigurationVideo priceBilling conditionsaudio: without_audio; resolution: 4kCharge
Output · Video price $0.5 per video second

Published price reference for the configuration shown. Final charges follow the actual billed configuration.

ConfigurationVideo priceBilling conditionsaudio: without_audio; resolution: 720pCharge
Output · Video price $0.16 per video second

Published price reference for the configuration shown. Final charges follow the actual billed configuration.

Example requests

Ailoot Ultra · Video

curl · exact configured profile
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1-fast", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT

Receive and save results

Ailoot Ultra · Video

mp4

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/videos/generations/{request_id}/content
Check job status
GET original status
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Other content reads
Save every completed owned output
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Keep all completed results

Save every completed video or returned file; retrieve every actual returned asset URL.

Keep every completed data[] signed owned URL and the full status metadata. Save every output, including its generated audio. A valid AAC audio track can be present even with generate_audio=false; keep the complete original MP4 including that audio.

If the original response needs checking

Read existing original job; never resubmit unknown send.

Maximum outputs: 4.

Response fields
FieldTypeMeaning
FieldidTypestringMeaning—
FieldobjectTypestringMeaning—
FieldmodelTypestringMeaning—
FieldstatusTypestringMeaning—
Fielddata[]Typesigned content URLMeaning—
Fieldcharge_pending_checkTypebooleanMeaning—
Fielderror.codeTypestringMeaning—
Fielderror.messageTypestringMeaning—
Fieldoperation_idTypestringMeaningHTTP503 result_pending_check original status/content response: same original public video ID as id.
Fielderror.typeTypestringMeaningserver_error on HTTP503 result_pending_check.
Errors and next steps
ResponseConditionNext step
Response400 · invalid_request_errorConditionReading the raw request body fails before parsing the video profileNext stepPreserve the returned response and correct the unreadable request body.
Response422 · price_unavailableConditionParsing the exact video profile fails, or the complete parsed profile has no ready exact price cardNext stepPreserve the response; use the complete exact admitted profile and its published card. This branch runs before a provider send.
Response409 · video_not_readyConditionOriginal result content is not yet availableNext stepPoll the original returned ID and respect Retry-After.
Responseserver_errorConditionThe returned response says the operation or result requires a checkNext stepKeep the original returned operation/task ID, request headers and response; continue supported reads of that original operation. Do not resubmit the creation request.
Response503 · result_pending_checkConditionGET original status/content: task is not published, original job is not failed/cancelled/expired, and local state is unknown or original job status is completed.Next stepKeep original id and operation_id (same public video ID), response and headers; read only the original status/content. Never submit a new generation request.

Aliases

Model aliases

Ailoot Ultra google/veo-3.1-fast

Method path aliases

/v1/videos/generations, /videos, /videos/generations

Related caller IDs

google/veo-3.1-fast

FAQ · Google: Veo 3.1 Fast
What inputs and results are available?

POST /v1/videos · google/veo-3.1-fast: text → video

Which fields does the request use?

POST /v1/videos · google/veo-3.1-fast: model, prompt, duration, resolution, aspect_ratio, generate_audio

More details

Connect Ailoot to Claude Code, OpenCode, Hermes or your own app.

The company and its project portfolio

The company and its project portfolio: millions of customers; monthly sales in the billions.

Buy tokens at a discount.

Subscription discounts for regular use. Promo codes offer up to 50% off token purchases.

Subscription
Choose a discounted plan for your regular requests.
Promo code: up to 50% off
Enter your code at checkout. The price updates to reflect the current promotion.
Spending in your history
The model, tokens and amount are recorded for each request.

Choose a subscription · View model prices

Connect the API to a product you sell.

Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale.

Commercial application
Add text, image, video and audio generation to paid features in your service.
Reseller licence
Send a description of your project and how you provide access. Request written terms for use and resale.
Documents on the website
The service offer, licence agreement and data processing policy are available before you connect.

Request a reseller licence · Service offer and licence agreement