Skip to main content
POST
/
v3
/
async
/
veo-3.1-generate-img2video
Veo 3.1 Image-to-Video
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/veo-3.1-generate-img2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image": "<string>",
  "last_image": "<string>",
  "reference_images": [
    {
      "image": "<string>",
      "reference_type": "<string>"
    }
  ],
  "aspect_ratio": "<string>",
  "duration_seconds": 123,
  "enhance_prompt": true,
  "generate_audio": true,
  "negative_prompt": "<string>",
  "person_generation": "<string>",
  "resolution": "<string>",
  "sample_count": 123,
  "seed": {}
}
'
{
  "task_id": "<string>"
}
The Veo 3.1 Preview API has been automatically made compatible with this endpoint
Use the Veo 3.1 video generation model to generate high-quality video content from an input image and text description. This endpoint uses asynchronous processing, and you need to query the final generated result using the task_id.

​
Request Headers

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

​
Request Body

​
prompt
string
required
A text string describing the video you want to generate.
​
image
string
Input image, supporting either a URL or base64-encoded format.
​
last_image
string
Ending image, used to fill the last frame of the video. Supports either a URL or base64-encoded format.
​
reference_images
object[]
A list of up to three asset images or up to one style image, used to describe the reference images the model should use when generating the video.
​
aspect_ratio
string
Specifies the aspect ratio of the generated video.Enum values: 16:9, 9:16. The default value is 16:9.
​
duration_seconds
integer
The length of the video file you want to generate, in seconds.Enum values: 4, 6, 8; when using reference_images, it can only be 8.The default value is 8.
​
enhance_prompt
boolean
Specifies whether to use Gemini to enhance your prompt. Only true is supported.Default value: true
​
generate_audio
boolean
required
Specifies whether to generate audio for the video.
​
negative_prompt
string
A text string describing what you want to prevent the model from generating.
​
person_generation
string
A safety setting that controls whether person or face generation is allowed.Enum values:
  • allow_adult (default): Only allows generating adults
  • dont_allow: Does not allow people or faces to be included in the image
  • allow_all: Allows generating people of all ages (requires the project to be on the allowlist)
​
resolution
string
The resolution of the generated video.Enum values: 720p (default) or 1080p
​
sample_count
integer
The number of video samples to generate.Value range: 1-4
​
seed
uint32
A number used to initialize the random generation process. Using the same seed, prompt, and other parameters will produce the same output video, making the generation process deterministic.Value range: 0-4,294,967,295

​
Response Parameters

​
task_id
string
required
The task_id of the asynchronous task. You should use this task_id to request the Query Task Result API to obtain the generated result