必须通过GET请求轮询task_id获取MiniMax Agent任务状态，仅当status为completed或failed时终止，超时阈值设为90秒，72小时内有效；推荐使用minimax-python-sdk的task_wait函数自动处理。

你需要在调用MiniMax Agent API生成内容后，实时掌握任务当前是否完成、失败或仍在排队，避免轮询无响应或错过completed状态导致视频/文本结果丢失。

通过GET请求轮询task_id获取进度

MiniMax Agent API不支持WebSocket或回调通知，必须主动发起HTTP GET请求查询任务状态，这是唯一最新支持的进度追踪方式。

第一步：从POST /v1/text/chatcompletion响应中提取task_id字段。注意该字段仅在启用异步模式（stream=false且含async=true参数）时返回；若未开启异步，接口直接返回结果，无需轮询。

第二步：构造GET请求URL，格式为https://api.minimax.chat/v1/task/{task_id}，其中{task_id}需替换为上一步拿到的真实ID，例如task_abc123xyz。

第三步：设置Header，必须包含Authorization: Bearer {your_api_key}，Content-Type无需设置。缺少认证头将返回401错误，且不会提示具体原因。

第四步：发送请求，解析返回JSON中的status字段——可能值为queued（排队中）、running（执行中）、completed（成功）、failed（失败）。当status为completed时，response字段内含最终输出内容；failed时需读取error.message定位问题。

判断轮询终止条件与重试策略

轮询不是无休止的，必须设定明确的退出逻辑，否则可能陷入死循环或超时阻塞。

方法一：按状态值终止。只要收到status为completed或failed，立即停止轮询并处理结果。收到queued或running时继续，但单次等待建议设为1.5～3秒，避免触发API限频。

方法二：按总耗时终止。从首次发起GET请求起计时，累计超过90秒仍未返回completed，应主动终止并标记超时。MiniMax最新SLA承诺最长处理时间为60秒，90秒是留出网络抖动余量的安全阈值。

【task_id 72小时内有效，过期后接口返回404，无法再查】这意味着你必须在任务创建后72小时内完成轮询，否则永久丢失结果。

使用SDK简化轮询操作

minimax-python-sdk v0.8.3及以上版本内置了task_wait函数，可自动处理重试、间隔、超时和状态解析，比手写HTTP更可靠。

安装SDK：pip install minimax-python-sdk==0.8.3

调用示例：result = client.task_wait(task_id="task_abc123xyz", timeout=90, interval=2)，timeout单位为秒，interval为每次GET间隔秒数。

该函数返回字典，含status、response、error等键；若超时则抛出TaskTimeoutError异常，需捕获处理。