Image to Video

minimax-hailuo-2.3-fast

Hailuo 2.3 Fast image-to-video generation.

POST /v1/videos/generationsAsync generation

Quick start

Submit a request with this public model ID. The API immediately returns a normalized job; poll GET /v1/jobs/{jobId} while its status is queued or running.

curl -X POST "https://api.artany.ai/v1/videos/generations" \
  -H "Authorization: Bearer $ARTANY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{"model":"minimax-hailuo-2.3-fast","prompt":"Ocean waves at sunrise","duration":6,"resolution":"768p","first_frame_image":"https://example.com/first-frame.jpg","prompt_optimizer":true,"fast_pretreatment":false}'

Request

Headers

Header	Required	Description
Authorization	Yes	Bearer token for an Artany API key.
Content-Type	Yes	Must be application/json.
Idempotency-Key	Recommended	8–128 characters. Reusing it with an identical request prevents duplicate jobs and charges.

Body

{
  "model": "minimax-hailuo-2.3-fast",
  "prompt": "Ocean waves at sunrise",
  "duration": 6,
  "resolution": "768p",
  "first_frame_image": "https://example.com/first-frame.jpg",
  "prompt_optimizer": true,
  "fast_pretreatment": false
}

Request Parameters

Only fields in this model’s public request contract are shown. Defaults are applied before validation and quoting.

Note:Fast text-to-video and first-frame image-to-video workflow.

modelstringrequireddefault: "minimax-hailuo-2.3-fast"

Stable public model ID for this request.

promptstringrequired

Video content description. Include subject movement, environment, and camera action.

Length: 0–2000

durationintegerdefault: 6

Target video duration in seconds.

Allowed: 6, 10

610

Note:Only 5 and 10 second durations are supported.

resolutionstringdefault: "768p"

Output resolution tier.

Allowed: 768p, 1080p

768p1080p

first_frame_imagestringrequired

Opening image for image-to-video generation.

"https://example.com/first-frame.jpg"

prompt_optimizerbooleandefault: true

Whether to apply supported automatic prompt optimization before generation.

fast_pretreatmentbooleandefault: false

Whether to apply supported fast preprocessing to the supplied request.

Use Cases

Choose the request shape that matches the source media you provide. The examples use the public model ID and accepted public fields.

Text-to-video

Create a fast video from a prompt.

{
  "model": "minimax-hailuo-2.3-fast",
  "prompt": "Ocean waves at sunrise",
  "duration": 6,
  "resolution": "768p"
}

Image-to-video

Use an opening image to condition motion.

{
  "model": "minimax-hailuo-2.3-fast",
  "prompt": "Gentle camera push-in",
  "first_frame_image": "https://example.com/first-frame.jpg",
  "duration": 6
}

Response and task status

A successful asynchronous submission returns HTTP 202 with a supplier-neutral job.

{
  "id": "job_…",
  "object": "generation.job",
  "model": "minimax-hailuo-2.3-fast",
  "status": "queued",
  "progress": 0,
  "output": null,
  "error": null,
  "billing": {
    "estimated_credits": "…",
    "frozen_credits": "…",
    "charged_credits": "0",
    "state": "frozen",
    "price_version": "2026-07-18.picverse-parity"
  },
  "created_at": "2026-07-21T00:00:00.000Z",
  "completed_at": null
}

queued / running: continue polling.
succeeded: retrieve media URLs from output; billing has settled.
failed / canceled: inspect error; frozen Credits are released.