Skip to main content
POST
Veo 3.1 Fast

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be veo3_1_fast.

Available options:
veo3_1_fast
prompt
string
required

Text prompt describing the video. Max 2000 tokens. Translated to English automatically.

image_url
string<uri>

Optional. First-frame image URL (≤10MB). Switches the request to first/last-frame mode.

image_end_url
string<uri>

Optional. Last-frame image URL. Requires image_url — last-frame-only is not supported.

ref_imgs
string<uri>[]

Optional. Up to 3 reference images (≤10MB each). Switches the request to reference mode, which fixes duration to 8s and aspect ratio to 16:9. Cannot be combined with image_url / image_end_url. image_urls is accepted as a compatible alias.

Maximum array length: 3
duration
enum<integer>
default:4

Video duration in seconds. ⚠️ Fixed at 8 when ref_imgs is used.

Available options:
4,
6,
8
quality
enum<string>
default:720p

Output resolution. Both tiers cost the same. resolution is accepted as a compatible alias.

Available options:
720p,
1080p
ratio
enum<string>
default:auto

Output aspect ratio. auto lets the model pick from the input image, or from the prompt for text-to-video. ⚠️ Fixed at 16:9 when ref_imgs is used. aspect_ratio is accepted as a compatible alias.

Available options:
auto,
16:9,
9:16
generate_audio
boolean
default:false

Generate an audio track. ⚠️ Costs ~49% more per second. Defaults to false here (Google's own default is true).

custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required