Run the MiniMax agent
minimax_run_agentGive the hailuoai.video AI agent a task in plain words ("generate a 16:9 video of…", "generate an image…", "generate a song based on my lyrics") and the models it may use; it picks among them and returns the files it made. Optional reference files by public URL. Uses the account's MiniMax credits. Runs as a job: waits up to ~50 s, then returns the jobId for minimax_get_agent_job. For direct control use minimax_create_video / minimax_create_image. POST /agent.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>",
"models": "<models>"
},
"name": "minimax_run_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait | No | Wait up to ~50 s for the job to finish (default true); false returns the id at once. | |
| models | Yes | The models the agent may use, e.g. ["hailuo-2.3", "nano-banana-2"]. Video: hailuo-2.3, hailuo-2.3-fast, hailuo-02, veo-3.1, veo-3.1-fast, veo-3.1-s2v, veo-3.1-s2v-fast. Image: nano-banana-2, nano-banana, seedream, kontext, qwen, kolors, midjourney-v7, midjourney-niji7, seedream-5.0. Audio: speech-2.5-hd-preview, speech-2.5-turbo-preview, minimax-music-2.0. | |
| prompt | Yes | The task. Say what to make (video, image, song, speech), and the aspect ratio or resolution if it matters. | |
| account | No | The account id from minimax_list_accounts. Optional when you have one account, required with more. | |
| fileUrls | No | Up to 3 public https URLs of reference files (images to edit or animate, for example), each up to 20 MB; downloaded here and attached to the request. | |
| replyRef | No | Optional reference of yours, stored and returned with the result and webhook. Up to 1,024 characters. | |
| replyUrl | No | Optional webhook: the API POSTs the finished result (same shape as the get tool's record) to this URL. Up to 1,024 characters. |