Appendix: Camera Movement Instructions & Webhooks

Version: v1.0.0 | Last Updated: 2026-06-05
This platform fully supports the Hailuo (MiniMax / Hailuo) video generation API. Requests and responses are transparently proxied, and all parameter semantics remain consistent with the official API.

1. Camera Movement Instructions ([instruction] Syntax)

For models that support camera movement, you can add [instruction] directives within the prompt to achieve precise camera control. A total of 15 camera movement instructions are supported:

Category	Instructions
Horizontal Pan	`[Truck left]`, `[Truck right]`
Horizontal Rotate	`[Pan left]`, `[Pan right]`
Push/Pull	`[Push in]`, `[Pull out]`
Vertical Move	`[Pedestal up]`, `[Pedestal down]`
Vertical Rotate	`[Tilt up]`, `[Tilt down]`
Zoom	`[Zoom in]`, `[Zoom out]`
Other	`[Shake]`, `[Follow]`, `[Static shot]`

Usage Rules

Combined movements: Multiple instructions within the same [] take effect simultaneously, e.g., [Pan left,Pedestal up]. It is recommended to combine no more than 3 instructions.

Sequential movements: Instructions appearing in different positions in the prompt take effect in order, e.g., "...[Push in], then...[Pull out]".

Natural language: Camera movements described in natural language are also supported, but using standard instructions yields more accurate results.

2. Webhooks (callback_url)

Use the callback_url parameter to configure webhooks for receiving asynchronous task status updates.

URL Verification: After configuration, the server sends a POST request to the callback_url containing a challenge field. Your server must return the challenge value as-is within 3 seconds to complete verification.

Status Updates: Once verified, the URL receives a push notification whenever the task status changes. The push data structure is consistent with the Query Task Status response body.

Webhook push status values:

Status	Description
`processing`	Video is being generated
`success`	Task completed successfully
`failed`	Task failed

Status Update Push Body Example

{
  "task_id": "115334141465231360",
  "status": "success",
  "file_id": "205258526306433",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Webhook Server Reference Implementation (Python / FastAPI)

99-Appendix-Camera-Movement-and-Webhooks

Appendix: Camera Movement Instructions & Webhooks#

1. Camera Movement Instructions ([instruction] Syntax)#

2. Webhooks (callback_url)#

Appendix: Camera Movement Instructions & Webhooks

1. Camera Movement Instructions ([instruction] Syntax)

2. Webhooks (callback_url)