Hailuo 2.3 (Image to Video)

Run it

The smallest request that works: the required fields only.

curl https://api.percify.io/v3/playground/v1/run \
  -H "Authorization: Bearer $PERCIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "hailuo-23-i2v",
    "input": {
      "image": "https://example.com/photo.jpg"
    }
  }'

1. EstimatePOST /estimate with the same body returns the price and charges nothing.
2. RunPOST /run returns an id at once, with status processing.
3. CollectGET /generations/{id}?wait=55 returns the file URLs, or pass a webhook.

Parameters

4 fields in input, required first.

• imageRequired
  string

  The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64,{data} format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the fol

• promptOptional
  string

  The positive prompt for the generation.

• durationOptional
  6, 10Default 6

  The duration of the generated media in seconds.

• enable_prompt_expansionOptional
  booleanDefault false

  The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks.