Skip to main content
POST
Hailuo H3 Reference to Video

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be hailuo_h3_refs.

Available options:
hailuo_h3_refs
prompt
string
required

Text prompt describing the video. Required. Max 7000 characters.

Maximum string length: 7000
ref_imgs
string<uri>[]

Reference images (up to 9). JPG/PNG/WEBP/HEIC/HEIF, ≤30MB each, 256–5760px, aspect ratio 0.4–2.5.

Maximum array length: 9
ref_videos
string<uri>[]

Reference videos (up to 3). mp4/mov, 2–15s each and ≤15s total, ≤50MB each, frame rate 23.976–60.

Maximum array length: 3
ref_audios
string<uri>[]

Reference audio (up to 3). wav/mp3, 2–15s each and ≤15s total, ≤15MB each. Requires at least one ref_imgs or ref_videos item.

Maximum array length: 3
resolution
enum<string>
default:2K

Output resolution. Only 2K is available today; 768P is coming soon.

Available options:
2K
duration
integer
default:5

Video duration in seconds. Any integer from 4 to 15.

Required range: 4 <= x <= 15
ratio
enum<string>
default:adaptive

Aspect ratio. Defaults to adaptive (chosen automatically from the reference assets).

Available options:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required