MiniMax H3 Video Generate
Generate a video with audio using MiniMax H3. A text prompt is required. For text-to-video, omit both image URLs. To guide the opening frame, provide a public HTTPS URL in `image_url`. You can also provide a public HTTPS URL in `end_image_url` to guide the final frame, but a final image alone is not supported. Choose a duration of 5–15 whole seconds (default: 5), a resolution tier of 480P, 768P, 1080P, 2K, or 4K (default: 2K), and an aspect ratio of 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16 (default: 16:9). You can optionally set `seed` to a nonnegative safe integer (0–9,007,199,254,740,991). Resolution tiers do not guarantee exact pixel dimensions, and a fixed seed does not guarantee frame-by-frame reproducibility. Submission returns a task ID. Use it with `ae_get_result` to check progress and retrieve the video URL when the task completes.
Pricing
| Condition | Charge |
|---|---|
| 480P in 16:9 or 9:16, with no images or both frames, and with seed omitted, null, or between 0 and 9,999,999,999 | 8.41 credits/second |
| 768P in 16:9 or 9:16, with no images or both frames, and with seed omitted, null, or between 0 and 9,999,999,999 | 11.77 credits/second |
| 480P or 768P with only a first frame, another aspect ratio, or a seed greater than 9,999,999,999 | 18.47 credits/second |
| 1080P or 2K | 18.47 credits/second |
| 4K | 92.31 credits/second |
Multiply the listed per-second rate by the requested duration. The minimum duration is 5 seconds. A five-second 480P clip meeting the first row's conditions is 42.05 credits. Only successful tasks are charged.
Defaults to 2K and 5 seconds when omitted.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.seed | integer | null | No | 可选随机种子。允许 0 至 9007199254740991 的整数,省略或传 null 时随机生成。固定 seed 不保证逐帧一致。 | — |
request_body.prompt | string | Yes | Text prompt for video generation | — |
request_body.duration | integer | No | The duration of the video in seconds. | 5 |
request_body.image_url | string | No | 可选。首帧图片的公开 HTTPS 链接。传首帧时生成图生视频,省略时按文字生成。 | — |
request_body.resolution | enum (480P | 768P | 1080P | 2K | 4K) | No | 输出分辨率档位,省略时为 2K。最终像素尺寸随供应商和宽高比变化。 | 2K |
request_body.aspect_ratio | enum (21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16) | No | The aspect ratio of the generated video. | 16:9 |
request_body.end_image_url | string | No | 可选。尾帧图片的公开 HTTPS 链接。使用时需同时传入 image_url。 | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_minimax_h3_video_generate' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"prompt": "A white kitten chases a butterfly across a sunlit garden. Gentle camera tracking, natural movement, soft afternoon light filtering through the leaves."
}
}
}'No response example available yet.




