MiniMax

Hailuo 2.3

hailuo-2.3-fast/image-to-video

A video generation model launched by MiniMax that supports both text-to-video and image-to-video, with improvements over the previous generation in anime-style consistency, full-body motion rendering, and the realism of subtle facial expressions, making it suitable for anime shorts and live-action-feel commercial videos

hailuo-2.3-fast/image-to-video hailuo-2.3/image-to-video hailuo-2.3/text-to-video

Try hailuo-2.3-fast/image-to-video

Input

Showcases

View all showcases

Output

video

Fill in the parameters and run — results show up here.

Pricing

hailuo-2.3-fast/image-to-video per video

Specifications	Unit Price
6S	$0.270
10S	$0.460

Positioning Overview

Hailuo 2.3-Fast is the fast image-to-video variant in the MiniMax Hailuo 2.3 series. It accepts a first-frame image and a text prompt to generate a 6-second or 10-second video, with an emphasis on the naturalness of character motion and facial micro-expressions, as well as stable output for anime and other stylized visuals. It is suited to developers who need to quickly test-shoot from a single image, iterate on storyboards, or produce short video assets, and can be integrated through the unified HiAPI.ai API.

Core Highlights

A lightweight, fast image-to-video variant — the same series also offers a full version and a text-to-video model; Fast focuses on the efficiency of single-image-driven output, making it suitable for early rapid test-shoots and iteration.
First-frame image directly drives motion — simply provide one jpeg, png, or webp first-frame image along with a prompt to generate continuous moving footage.
Optional automatic prompt optimization — prompt_optimizer is enabled by default, improving generation results without rewriting the prompt.
Two duration options: 6 seconds and 10 seconds — switch durations to balance asset length and generation cost, covering short video and storyboard draft needs.

Capability Description

Single-image first-frame video generation: pass in a first-frame image and a text description to output a motion video, directly turning static assets into playable video content.

Text prompt controls the picture: the prompt field supports descriptions up to 2000 characters, used to specify actions, camera shots, and picture content, controlling the generation direction.

Selectable duration: duration offers two options, 6 seconds and 10 seconds, so developers can choose the finished length according to the publishing platform or storyboard structure.

Automatic prompt optimization: prompt_optimizer is enabled by default and can automatically complete and rewrite prompts, reducing the trial-and-error cost of repeated parameter tuning.

Use Cases

Anime and stylized content creators: single character image + motion prompt — turn illustrations or character art into short video clips with motion, for anime shorts, social platform content, or dynamic posters.
Short video teams: character image + performance description — generate clips containing dance, body movements, or facial expressions from a character first frame, as finished footage or storyboard drafts.
Product and commercial promotion: product image + showcase script — turn product stills into dynamic showcase videos, for rapid output of e-commerce detail pages, feed ads, or promotional shorts.
Creative teams: script visualization test-shoots — quickly generate 6-second or 10-second clips from a single image to validate creative directions, then decide whether to proceed to formal production.

Limitations and Selection Advice

Only single first-frame image driving is supported, with no first-and-last frame control capability; input images must be jpeg, png, or webp, and SVG is not supported. The Fast version only does image-to-video and has no text-to-video path; if you need pure text-to-video generation or full-version picture quality, switch to the same series' text-to-video or full-version image-to-video model. Resolution and generation speed lack official parameter evidence, so it is recommended to run a small-batch test before making a selection.

What's new

View changelog →

New model New model available: hailuo-2.3-fast/image-to-video Nov 3, 2026

Frequently asked questions

View all FAQs →

Does Hailuo 2.3 Image to Video require an input image?

Yes. hailuo-2.3/image-to-video is an image-to-video route. The image establishes the subject and opening composition; the prompt directs motion, camera, and environmental change.
Which durations and resolutions does Hailuo 2.3 Image to Video support?

The current HiAPI contract supports 6s / 10s. Check the page controls and API docs for the current options.
How is Hailuo 2.3 Image to Video billed?

Each generated video is billed at the selected duration tier. The page follows the global display unit, while the successful task record contains the final charge.
How can I improve subject consistency?

Use a clear, unobstructed source with a complete composition. Describe the main action and camera first, then name the appearance, material, and background relationships that must remain stable. Validate a short clip first.

Create a generation task

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

Headers

AuthorizationstringRequired

Account API key. Required on every request. Example: Bearer YOUR_HIAPI_API_KEY. Get your API key

Content-TypestringOptional

The request body is always parsed as JSON; when sent, only application/json (optionally with charset) is accepted — any other value returns 415. Example: application/json.

Idempotency-KeystringOptional

Idempotency key, up to 255 bytes. Retries with the same key from the same account create the task only once; replays return the original taskId.

Idempotency key

On network timeouts or client retries, the same key creates the task only once — no double charges (scope: the API key's account). Use a business-unique identifier as the key (e.g. "order-42"); replays return the original taskId, and keys expire 24 hours after the first request. See the Unified Async API overview for the full scenario matrix.

Body

modelstringRequired

Current fixed value: hailuo-2.3-fast/image-to-video

routestringOptional

Current fixed value: default

inputobjectRequired

Business parameters for hailuo-2.3-fast/image-to-video and route default — see the parameter table below.

promptstringRequiredminLength 1maxLength 2000

Text description for video generation, used to specify the content of the desired generated footage. Takes a string value.

durationstringOptionalDefault: "6"

Duration of the generated video in seconds. Takes a numeric value in string form, default 6.

Options:610

image_urlstringRequired

URL of the first-frame image; only a single image is supported, in jpeg/png/webp format; SVG is not supported. Takes a string value.

prompt_optimizerbooleanOptionalDefault: true

Whether to automatically optimize the prompt for better generation results. Takes a boolean value, default true.

callbackobjectOptional

Terminal-state notification config. When omitted, no callback is delivered — poll the task yourself. See the callback note below.

Callbacks (Webhook)

Provide callback.url when creating a task and HiAPI POSTs to your service once the task reaches a terminal state — no polling needed. The callback payload mirrors the task detail structure; signature verification, delivery retries and idempotency are documented on the Unified Async API overview page.

urlstringRequired

Required when callback is present. A POST is sent to this URL once the task reaches a terminal state; must be a valid http(s) URL.

whenstringOptionalDefault: "final"

Only final is supported today — notified on both success and fail.

Options:final

storagestringOptionalDefault: "temp"

Artifact storage tier: temp (default, retained about 7 days) or persistent (long-term, billed by size). Insufficient balance or exceeding the storage cap silently downgrades to temp; the effective tier is shown in the task detail response.

Options:temppersistent

Request examples

# Submit an async task; returns a taskId immediately (no waiting for generation)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "hailuo-2.3-fast/image-to-video",
  "input": {
    "prompt": "…",
    "duration": "6",
    "image_url": "…",
    "prompt_optimizer": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "hailuo-2.3-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": "6",
      "image_url": "…",
      "prompt_optimizer": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "hailuo-2.3-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": "6",
          "image_url": "…",
          "prompt_optimizer": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Get task detail

GET https://api.hiapi.ai/v1/tasks/:id

Response fields

taskIdstringRequired

Task ID, always prefixed with tk-hiapi-.

modelstringRequired

Resolved full model name. Tasks submitted with the route parameter return base@route (e.g. gpt-image-2/text-to-image@ext); otherwise identical to the name passed at creation.

routestringOptional

Present only when the task was submitted with an explicit route parameter; echoes the submitted value.

statusstringRequired

Task status.

Status values

queued Queued, not started yet. handling Being processed. archiving Processing finished, artifacts being prepared. success Terminal: completed, artifacts available (output returned). fail Terminal: failed (error returned). After submission, check status: success and fail are terminal, everything else is non-terminal. Poll every 1–3 seconds until terminal. On success, download artifacts from output[].url and transfer them before expireAt; pass storage: "persistent" at creation time when long-term retention is needed.

creatednumberRequired

Task creation time (Unix seconds).

completednumberRequired

Unix seconds when the task reached a terminal state; fixed to 0 while not terminal.

outputarrayOptional

Present only when status == success. Artifact list — always an array; a single task may return multiple types at once (e.g. video + first_frame).

Array [ object ]

Array items

urlstringRequired

Artifact URL, directly downloadable.

typestringRequired

Current possible values: video, image, audio, first_frame, last_frame, thumbnail; more may be added later.

expireAtnumberRequired

Unix seconds until which the artifact remains accessible; download or transfer before it expires.

errorobjectOptional

Present only when status == fail.

codestringRequired

Business error code.

messagestringRequired

Error description.

Response examples

Success

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Processing (non-terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Failed

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}