Hailuo (Kie.ai) icon

Hailuo (Kie.ai)

Generate videos using Hailuo via Kie.ai API

Actions3

Image-to-Video

AI-generated

Summary

Generate a video from a specified input image URL using a selected Hailuo model and optional enhancements such as prompts, aspect ratio, duration, and more.

Inputs

  • Model — Choose the Hailuo image-to-video model variant to use (e.g., Hailuo 2.3 Pro recommended).
  • Prompt (required) — Provide a text prompt to guide the video generation from the input image.
  • Image URL (required) — Specify the URL of the input image that the video will be generated from.
  • End Frame URL — Optionally provide an image URL for the last frame of the video.
  • Aspect Ratio — Select the aspect ratio for the generated video (16:9, 9:16, or 1:1).
  • Duration (Seconds) — Set the video length, either 5 or 10 seconds.
  • Negative Prompt — Specify any elements to avoid appearing in the generated video.
  • Seed — Provide a seed number for reproducible results; zero means random seed.
  • Reply URL — Enter a webhook URL to receive a callback when the video generation task completes.
  • Reply Ref — Pass a custom reference string that the webhook callback will include.
  • Wait for Completion — Choose whether to wait synchronously for the video generation task to finish (polls every 3 seconds up to 5 minutes).

Output shape

a single JSON object with the job creation response or the final completed task details including URLs of generated video frames or video files

If 'Wait for Completion' is true, the operation polls the task status until it completes or times out after 5 minutes and returns the full task result. If false, it returns immediately with creation response containing the task ID. The response includes parsed fields like video URLs for easy workflow access.

Examples

Example 1: Generate a 5-second 16:9 video from a given image using the recommended Pro model, with a prompt guiding the visual content.

Set Model to 'Hailuo 2.3 Pro (Recommended)', provide 'Prompt' describing desired video content, input 'Image URL', and use defaults for duration and aspect ratio. Enable 'Wait for Completion' to synchronously receive video URLs after generation.

Links

Discussion