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-fastOverview
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
| Field | Type | Requirement | Values & limits | Default |
|---|---|---|---|---|
Fieldmodel | Typestring | RequirementRequired | Values & limits google/veo-3.1-fast | Default— |
Fieldprompt | Typestring | RequirementRequired | Values & limits Maximum UTF-8 bytes: 10,000 Non-whitespace required: Yes | Default— |
Fieldduration | Typeinteger | RequirementRequired | Values & limits 4, 6, 8 | Default— |
Fieldresolution | Typestring | RequirementRequired | Values & limits 720p | Default— |
Fieldaspect_ratio | Typestring | RequirementRequired | Values & limits 16:9, 9:16 | Default— |
Fieldgenerate_audio | Typeboolean | RequirementRequired | Values & limits false, true | Default— |
Input material combinations
Text to video · Required: prompt
Method parameters and lifecycle
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parameteradditional_properties | Contractfalse |
Parameterparameters | Contract{"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_types | Contracttext |
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.
| Configuration | Rate schedule | Forecast quantity | Generate audio | Resolution | Billing unit | Billing conditions | Charge |
|---|---|---|---|---|---|---|---|
| ConfigurationBase token rates | Rate scheduleBase rate | Forecast 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 price | Rate schedule— | Forecast quantity— | Generate audio— | Resolution— | Billing unitper video second | Billing conditionsaudio: with_audio | Charge Output · Video price · Estimate for comparison only $0.24 per video second |
| ConfigurationVideo price | Rate schedule— | Forecast quantity— | Generate audio— | Resolution— | Billing unitper video second | Billing conditionsaudio: with_audio; resolution: 4k | Charge Output · Video price · Estimate for comparison only $0.6 per video second |
| ConfigurationUltra | Rate schedule— | Forecast quantityRequested configuration; estimate only. | Generate audioWith audio | Resolution720p | Billing unitper output video second | Billing 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 price | Rate schedule— | Forecast quantity— | Generate audio— | Resolution— | Billing unitper video second | Billing conditionsaudio: without_audio | Charge Output · Video price · Estimate for comparison only $0.2 per video second |
| ConfigurationVideo price | Rate schedule— | Forecast quantity— | Generate audio— | Resolution— | Billing unitper video second | Billing conditionsaudio: without_audio; resolution: 4k | Charge Output · Video price · Estimate for comparison only $0.5 per video second |
| ConfigurationUltra | Rate schedule— | Forecast quantityRequested configuration; estimate only. | Generate audioWithout audio | Resolution720p | Billing unitper output video second | Billing 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 cost | Rate schedule— | Forecast quantityone generation estimate | Generate 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.
| Configuration | Billing conditions | Charge |
|---|---|---|
| ConfigurationVideo price | Billing conditionsaudio: with_audio | Charge Output · Video price $0.24 per video second Published price reference for the configuration shown. Final charges follow the actual billed configuration. |
| ConfigurationVideo price | Billing conditionsaudio: with_audio; resolution: 4k | Charge Output · Video price $0.6 per video second Published price reference for the configuration shown. Final charges follow the actual billed configuration. |
| ConfigurationVideo price | Billing conditionsaudio: without_audio | Charge Output · Video price $0.2 per video second Published price reference for the configuration shown. Final charges follow the actual billed configuration. |
| ConfigurationVideo price | Billing conditionsaudio: with_audio; resolution: 720p | Charge Output · Video price $0.2 per video second Published price reference for the configuration shown. Final charges follow the actual billed configuration. |
| ConfigurationVideo price | Billing conditionsaudio: without_audio; resolution: 4k | Charge Output · Video price $0.5 per video second Published price reference for the configuration shown. Final charges follow the actual billed configuration. |
| ConfigurationVideo price | Billing conditionsaudio: without_audio; resolution: 720p | Charge 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
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}/contentGET /v1/videos/generations/{request_id}/content
Check job 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
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
| Field | Type | Meaning |
|---|---|---|
Fieldid | Typestring | Meaning— |
Fieldobject | Typestring | Meaning— |
Fieldmodel | Typestring | Meaning— |
Fieldstatus | Typestring | Meaning— |
Fielddata[] | Typesigned content URL | Meaning— |
Fieldcharge_pending_check | Typeboolean | Meaning— |
Fielderror.code | Typestring | Meaning— |
Fielderror.message | Typestring | Meaning— |
Fieldoperation_id | Typestring | MeaningHTTP503 result_pending_check original status/content response: same original public video ID as id. |
Fielderror.type | Typestring | Meaningserver_error on HTTP503 result_pending_check. |
Errors and next steps
| Response | Condition | Next step |
|---|---|---|
Response400 · invalid_request_error | ConditionReading the raw request body fails before parsing the video profile | Next stepPreserve the returned response and correct the unreadable request body. |
Response422 · price_unavailable | ConditionParsing the exact video profile fails, or the complete parsed profile has no ready exact price card | Next stepPreserve the response; use the complete exact admitted profile and its published card. This branch runs before a provider send. |
Response409 · video_not_ready | ConditionOriginal result content is not yet available | Next stepPoll the original returned ID and respect Retry-After. |
Responseserver_error | ConditionThe returned response says the operation or result requires a check | Next 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_check | ConditionGET 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
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