Skip to main content
POST
/
v3
/
async
/
veo-3.1-lite-i2v
Veo 3.1 Lite Image-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-lite-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "seed": 123,
  "image": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "resolution": "<string>",
  "aspect_ratio": "<string>",
  "sample_count": 123,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "person_generation": "<string>"
}
'
{
  "task_id": "<string>"
}
Generate videos from input images using the Google Veo 3.1 Lite model. Supports durations of 4, 6, and 8 seconds, 720p and 1080p resolutions, and 16:9 and 9:16 aspect ratios. Optional audio generation. Input images can be up to 20MB.
This is an asynchronous API and only returns the task_id of the async task. You should use this task_id to request the Get Task Result API to retrieve the generated result.

​
Request Headers

​
Content-Type
string
required
Enum value: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API key}}.

​
Request Body

​
seed
integer
Random seed used to reproduce generation results.Value range: [0, 4294967295]
​
image
string
required
Input image. Supports image URLs or Base64-encoded data. Supported formats: JPEG, PNG. Maximum 20MB. Recommended resolution is 720p (1280x720) or higher, with an aspect ratio of 16:9 or 9:16.
​
prompt
string
required
Text prompt describing the desired video content to generate.
​
duration
integer
default:8
Duration of the generated video, in seconds.Allowed values: 4, 6, 8
​
resolution
string
default:"720p"
Output video resolution.Allowed values: 720p, 1080p
​
aspect_ratio
string
default:"16:9"
Output video aspect ratio.Allowed values: 16:9, 9:16
​
sample_count
integer
default:1
Number of generated video samples (1-4).Value range: [1, 4]
​
generate_audio
boolean
default:false
Whether to generate audio at the same time.
​
negative_prompt
string
Describe the content to avoid in the generated video.
​
person_generation
string
default:"allow_adult"
Whether to allow generating adult people. allow_adult: allow generating adults; dont_allow: do not allow generating people.Allowed values: allow_adult, dont_allow

​
Response

​
task_id
string
Use the task_id to request the Get Task Result API to retrieve the generated output.