Hailuo Video API Documentation

Overview

Generate videos with Hailuo from text prompts or image references with configurable duration and output settings.

Primary Endpoint

POST/api/v1/hailuoVideo/start

Start Hailuo video generation

Request Parameters

Name	Type	Required	Description
name	string	No	Task name (optional)
prompt	string	No	Text prompt describing the video content. Required.
image_urls	array<string>	No	Array of reference image URLs. At least one is required.
image_url	string	No	Single reference image URL (alternative to image_urls).
resolution	enum: 768P \| 1080P	No	Output video resolution. 1080P is not supported for 10s duration.
duration	enum: 6 \| 10	No	Video duration in seconds.
webhook_url	string	No	HTTPS URL to receive task.completed / task.failed notifications. Best-effort delivery, single attempt, no retries; clients should treat the detail API as the source of truth.
webhook_token	string	No	Optional plaintext token returned in the X-A2e-Webhook-Token header so receivers can verify the request originated from a2e.

Request Example

curl -X POST "https://www.a2e.com.cn/api/v1/hailuoVideo/start" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "My Hailuo Video",
  "prompt": "A cat playing with a ball of yarn",
  "image_urls": [
    "https://example.com/image.jpg"
  ],
  "image_url": "https://example.com/reference.jpg",
  "resolution": "768P",
  "duration": "6",
  "webhook_url": "https://your-server.example.com/a2e/webhook",
  "webhook_token": "a-shared-secret"
}'

Related Endpoints

POST/api/v1/hailuoVideo/start

Start Hailuo video generation

GET/api/v1/hailuoVideo/allRecords

Get Hailuo Video task list

GET/api/v1/hailuoVideo/{_id}

Get Hailuo Video task detail

DELETE/api/v1/hailuoVideo/{_id}

Delete Hailuo Video task

Responses

200

Task started successfully

401

Unauthorized - Invalid or missing bearer token