MiniMax H3 Edit API reference
Change the light, weather or style of a clip; people and motion stay
Call MiniMax H3 Edit from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in USD, and a request you can paste into a terminal.
At a glance
- Made by
- MiniMax
- Output
- Video
- From
- $0.03 USD per second of output
- Typical time
- about 131 s
- Model IDs
Prices are in USD, charged to your separate API wallet. A task reserves the maximum possible charge when accepted and settles actual usage on completion; any remainder is released. Failed tasks are not charged. Call POST /api/v1/jobs/quote for an exact quote before running.
Edit Video
minimax/h3-edit/video-edit
Price
| Option | USD |
|---|---|
480p | $0.03 per second of output |
540p | $0.045 per second of output |
768p | $0.066 per second of output |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | The change to make: lighting, weather, style, setting or specific elements. Name references as <Picture 1> or <Audio 1>. |
video_urlRequired | string (uri) | — | — | The clip to edit (MP4), up to 15 seconds; longer clips are refused before any charge. It keeps driving who is in it, the composition and the motion. |
reference_image_urlsOptional | array<string (uri)> | — | up to 9 items | Optional reference images, up to nine, named <Picture 1> to <Picture 9> in the prompt. Each one adds a per-reference charge. |
reference_audio_urlsOptional | array<string (uri)> | — | up to 3 items | Optional reference audio clips, up to three, named <Audio 1> to <Audio 3> in the prompt. Each one adds a per-reference charge. |
aspect_ratioOptional | string | — | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21 | Output aspect ratio. Leave it out to keep the source clip's shape. |
resolutionOptional | string | 768p | 480p, 540p, 768p | Output resolution. 768p is H3's own canvas; 480p and 540p are lower-cost, quicker tiers. |
duration_secondsOptional | integer | 5 | 3 to 15 | Length of the edited clip in whole seconds, 3 to 15. Set it to your source clip's length to edit the whole clip. |
generate_audioOptional | boolean | true | — | On: H3 generates a new soundtrack for the edit. Off: the source clip's own audio is kept. |
seedOptional | integer | — | 0 to 2147483647 | Random seed for controlled comparisons. |
Example request
This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.
The example uses PopNow sample files in video_url. Replace them with your own public HTTPS links, uploads or saved assets.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "minimax/h3-edit/video-edit",
"input": {
"prompt": "Recolor the flowers in soft pastel blue; keep the face and the motion unchanged",
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"duration_seconds": 5,
"resolution": "768p"
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"