Veo 3.1 Lite Text to Video API

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

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

Model summary

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

Veo 3.1 Lite text-to-video generates short clips with native audio at 720p or 1080p for fast creative iteration.

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

Fast creative validation

Test storyboards, shots, and prompts with short clips.

promptduration

Short clips with native audio

Create sound-enabled social and product clips.

generate_audioresolution

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/text-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": true,
    "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/text-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": true,
    "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/text-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": true,
    "safety_tolerance": "4"
  }
}),
});
console.log(await resp.json()); // Returns { code, message, data: { taskId } }

model string required

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

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

input object required

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

prompt string required

Text prompt describing the video to generate.

aspect_ratio enum optional

Output video aspect ratio.

default 16:9 enum: 16: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 true

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

Paper boat in a sunlit creek

Text-to-video golden example.

Request body

{
  "model": "veo-3.1-lite/text-to-video",
  "input": {
    "prompt": "A cat walking on the beach at sunset, cinematic",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8,
    "generate_audio": true,
    "auto_fix": true,
    "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

Which resolutions and durations are supported?

720p and 1080p are supported with 4, 6, or 8 second clips. View pricing