Hailuo 2.3 API: MiniMax Text and Image to Video

Use MiniMax Hailuo 2.3 with one Genflo API key to turn a text prompt or a single reference image into a 6 or 10 second video, from 768P up to 4K.

Complete request

This copy-ready shape includes every input field published for this model.

curl -X POST 'https://api.genflo.io/api/saas' \
  -H 'Content-Type: application/json' \
  -H 'x-apikey: sk-your-api-key' \
  -d '{
    "model": "hailuo-2.3",
    "input": {
      "prompt": "The camera slowly moves forward while the subject turns toward the light",
      "negative_prompt": "blur, distortion, artifacts",
      "enhance_prompt": true,
      "images": [
        "https://cdn.example.com/reference-image.jpg"
      ],
      "duration": 6,
      "resolution": "768P",
      "seed": 123456789
    }
  }'

Optional fields may be removed. The complete example demonstrates the JSON wire format; the upstream model may reject incompatible mode combinations, such as mixing frame animation with unrelated reference media.

How media fields are transmitted

Send media as public URL strings inside the JSON body—not as multipart uploads. A plural field such as videos is an array, for example ["https://cdn.example.com/reference.mp4"].

images → Image / Reference
videos → Video / Reference
audios → Audio / Reference
first_frame → Image / FirstFrame

Input parameters

7 fields are published for this model. Omitted optional fields are not sent upstream and have no gateway-defined default.

Field	Required	JSON type	Description and constraints	Example
`prompt`	Optional	`string`	The main instruction describing the output to generate.	`"The camera slowly moves forward while the subject turns toward the light"`
`negative_prompt`	Optional	`string`	Content and visual qualities the model should avoid.	`"blur, distortion, artifacts"`
`enhance_prompt`	Optional	`boolean`	Ask the upstream model to expand and optimize the prompt before generation.	`true`
`images`	Optional	`string[]`	Publicly reachable reference or source image URLs. Items: 0 to 1 · Formats: jpg, jpeg, png, webp	`["https://cdn.example.com/reference-image.jpg"]`
`duration`	Required	`number enum`	Requested video duration in seconds. It is also used to calculate the task charge. Allowed: 6, 10	`6`
`resolution`	Optional	`string enum`	Requested output resolution. Values are model-specific and case-sensitive at this API boundary. Allowed: 768P, 1080P, 2K, 4K	`"768P"`
`seed`	Optional	`integer`	Integer random seed. Reusing a seed can improve reproducibility, but identical output is not guaranteed.	`123456789`

Video requests require input.duration. The final charge is the per-second rate multiplied by duration.