> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimax Hailuo 2.3 Image to Video

Minimax Hailuo 2.3 is a new video generation model, breakthroughs in body movement, facial expressions, physical realism, and prompt adherence.

<Tip>
  This is an **asynchronous** API; only the **task\_id** will be returned. You should use the **task\_id** to request the [**Task Result API**](/docs/nl/api-reference/model-apis-task-result) to retrieve the video generation results.
</Tip>

## Request Headers

<ParamField header="Content-Type" type="string" required={true}>
  Supports: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer authentication format, for example: Bearer \{\{API Key}}.
</ParamField>

## Request Body

<ParamField body="prompt" type="string" required={true}>
  Prompt text required to guide the generation.

  Range: `1 <= x <= 2000`.

  Supported 15 camera commands:

  * Truck: \[Truck left], \[Truck right]
  * Pan: \[Pan left], \[Pan right]
  * Push: \[Push in], \[Pull out]
  * Pedestal: \[Pedestal up], \[Pedestal down]
  * Tilt: \[Tilt up], \[Tilt down]
  * Zoom: \[Zoom in], \[Zoom out]
  * Shake: \[Shake]
  * Follow: \[Tracking shot]
  * Static: \[Static shot]

  Usage rules:

  * Combined movements: Multiple commands inside one \[] take effect simultaneously (e.g., \[Pan left,Pedestal up]). Recommended max: 3.
  * Sequential movements: Commands appear in order, e.g., "...\[Push in], then...\[Push out]".
  * Natural language: Free-form descriptions also work, but explicit commands yield more accurate results.
</ParamField>

<ParamField body="image" type="string" required={true}>
  The image to be used for video generation. Supports public URL or Base64 encoding(`data:image/jpeg;base64,...`).
</ParamField>

<ParamField body="duration" type="integer" required={false}>
  The length of the generated video in seconds. Default: `6`<br />
  Optional values: `6`, `10`
</ParamField>

<ParamField body="resolution" type="string" required={false}>
  The resolution of the generated video. Default: `768P`

  * For 6-second videos: supports `768P`, `1080P`
  * For 10-second videos: supports `768P` only
</ParamField>

<ParamField body="enable_prompt_expansion" type="boolean" required={false}>
  Whether to enable prompt optimization.

  Default: `true`.
</ParamField>

<ParamField body="fast_pretreatment" type="boolean" required={false} default={false}>
  Whether to shorten the prompt optimization time.

  Default: `false`.
</ParamField>

## Response

<ResponseField name="task_id" type="string" required={true}>
  Use the task\_id to request the [Task Result API](/docs/nl/api-reference/model-apis-task-result) to retrieve the generated outputs.
</ResponseField>