Models · Video
Hailuo 2.3 API
Was this page helpful?
Hailuo 2.3 is good for generating short video shots when you need its listed duration, resolution, and framing options.
Pricing
Default example: 6-second video at 768P costs 33 credits, or $0.64 at the shared USD reference.
| Resolution | Unit | Credits | USD |
|---|---|---|---|
| 768P | Per 6-second video | 33 cr | $0.64 |
| 768P | Per 10-second video | 33 cr | $0.64 |
| 1080P | Per 6-second video | 33 cr | $0.64 |
| 1080P | Per 10-second video | 33 cr | $0.64 |
Accepted inputs
- Kind
- video
- Durations
- 6s, 10s
- Resolutions
- 768P, 1080P
- Aspect ratios
- default
- Defaults
- 6s · 768P · default
Sample request
The request uses the current default settings for this model and the public GenerateMediaRequest schema.
curl -X POST "https://reviral.ai/api/v1/generate-media" \
-H "Authorization: Bearer $REVIRAL_API_KEY" \
-H "Idempotency-Key: first-video" \
-H "Content-Type: application/json" \
--data '{"model":"hailuo-2.3","prompt":"A slow camera move across a quiet lake at sunrise","durationSec":6,"resolution":"768P","aspectRatio":"default","maxCredits":33}'Response and output
Accepted job
{
"data": {
"jobId": "550e8400-e29b-41d4-a716-446655440000",
"kind": "video",
"model": "hailuo-2.3",
"creditsCharged": 33,
"status": "queued",
"statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000"
}
}Ready job
{
"data": {
"jobId": "550e8400-e29b-41d4-a716-446655440000",
"kind": "video",
"model": "hailuo-2.3",
"creditsCharged": 33,
"status": "ready",
"statusUrl": "/api/v1/jobs/550e8400-e29b-41d4-a716-446655440000",
"outputUrl": "https://reviral.ai/signed-output",
"durationSec": 6
}
}Error cases
404 model_not_available: the ID is no longer in the live catalog.409 price_changed: the current cost differs frommaxCredits.422 validation_error: duration, resolution, aspect ratio, size, or count is not accepted.429 rate_limit_exceeded: wait forRetry-Afterbefore retrying.
Frequently asked questions
- How much does the Hailuo 2.3 API cost?
- The default 6-second video at 768P costs 33 credits, about $0.64 at the shared USD reference. Read the live models endpoint before submitting.
- Which inputs does Hailuo 2.3 accept?
- It accepts a prompt plus the listed durations, resolutions, and aspect ratios. Reference inputs are not available through this v1 endpoint.
- How do I retrieve Hailuo 2.3 output?
- Poll the returned status URL until the job is ready, then download the signed output URL or URLs before they expire.