Veo 3.1 Lite Image to Video API

POST Base URL: https://api.hiapi.ai /v1/tasks

Image, video, and audio models are called through the Unified Async API POST /v1/tasks endpoint; only the input fields differ (see input parameters below).

Model summary

Model name	veo-3.1-lite/image-to-video
Type	Video generation (image-to-video)
Endpoint	POST /v1/tasks
Pricing	See HiAPI Pricing

Veo 3.1 Lite image-to-video animates one input image into a short clip with native audio at 720p or 1080p.

Production guidance

For production, pass callback.url at the top level of the request body so HiAPI can notify your service when the task reaches a terminal state.
GET /v1/tasks/:id is better for local debugging, low-volume jobs, or fallback reconciliation if a callback is missed.
Use callback.when=final. Both success and fail are terminal states, so your service should deduplicate by taskId.

Best suited for

Animate a still image

Add camera motion and subject movement to an existing image.

image_urlprompt

Short social clips

Create sound-enabled 4, 6, or 8 second clips from one image.

durationgenerate_audio

Request parameters

POST https://api.hiapi.ai/v1/tasks

# Create an async task — returns taskId immediately (generation runs async)
# Replace YOUR_API_KEY with your account API key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1-lite/image-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "image_url": "",
    "aspect_ratio": "auto",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": false,
    "safety_tolerance": "4"
  }
}'

import requests, json

# Business params — fields vary by model (see the model page)
payload = json.loads(r'''
{
  "model": "veo-3.1-lite/image-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "image_url": "",
    "aspect_ratio": "auto",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": false,
    "safety_tolerance": "4"
  }
}
''')

# Create an async task — returns taskId immediately (generation runs async)
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # Returns { code, message, data: { taskId } }

// Create an async task — returns taskId immediately (generation runs async)
// Replace YOUR_API_KEY with your account API key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "veo-3.1-lite/image-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "image_url": "",
    "aspect_ratio": "auto",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": false,
    "safety_tolerance": "4"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

Fixed value veo-3.1-lite/image-to-video.

example veo-3.1-lite/image-to-video

input object required

Business parameters. Put Veo 3.1 Lite Image to Video-specific configuration here.

prompt string required

Text prompt describing how to animate the input image.

image_url string required

Image URL to animate; use a 720p-or-higher image in 16:9 or 9:16.

aspect_ratio enum optional

Output video aspect ratio.

default auto enum: auto16:99:16

resolution enum optional

Output video resolution.

default 720p enum: 720p1080p

duration enum optional

Clip length in seconds.

default 8 enum: 468

generate_audio boolean optional

Whether to generate native audio.

default true

negative_prompt string optional

Content to avoid in the generated video.

seed integer optional

Random seed for reproducible generation.

auto_fix boolean optional

Automatically rewrite prompts that fail validation.

default false

safety_tolerance enum optional

Content moderation tolerance level.

default 4 enum: 123456

callback object optional

Optional callback configuration. When set, HiAPI notifies your service when the task reaches a terminal state.

url string required

Required when callback is set; HTTPS URL that receives terminal task notifications.

example https://your-domain.com/hiapi/callback

when enum optional

Callback trigger timing. Use final.

default final enum: final

Example requests

Warm smile motion

Image-to-video golden example.

Request body

{
  "model": "veo-3.1-lite/image-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "image_url": "",
    "aspect_ratio": "auto",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": false,
    "safety_tolerance": "4"
  }
}

Getting the result

The response returns a taskId immediately without waiting for generation to finish.
In production, prefer waiting for callback.url to receive the terminal notification. For local debugging, poll GET /v1/tasks/:id.
When status=success, download the generated video from output[].url.
When status=fail, fix the request based on the returned error instead of retrying the same invalid payload.

FAQ

What input image should I provide?

Provide one 16:9 or 9:16 image; other aspect ratios may be cropped. View pricing