How Do I Query a MiniMax H3 Generation Task Status?

Overview

You check a task’s progress by calling the status endpoint with the task ID you got when you submitted the job. Confirm the exact endpoint and the status values in the current MiniMax H3 documentation, then read those states deliberately rather than assuming a single “done” flag covers every case.

Source note: Verified 2026-08-06 against the MiniMax official H3 blog, MiniMax Video Generation API docs, and Hugging Face MiniMax-H3 model page.

Handle the states explicitly. Return the output URL or payload when the status is completed. Treat failed, cancelled, timeout, and deleted as failure terminal states; read the error and decide whether to retry. Continue polling for every other status on a reasonable interval — a few seconds, backing off for longer jobs — instead of hammering the endpoint.

If webhooks are available, prefer them over aggressive polling, since a callback tells you the moment a job finishes without a tight loop consuming calls in the background.

Whichever you use, store the latest known status with the task so a page refresh or a service restart does not lose track of a job that is still running or already done, and so a user always sees an accurate state.