必须通过get请求轮询task_id获取minimax agent任务状态，仅当status为completed或failed时终止，超时阈值设为90秒，72小时内有效；推荐使用minimax-python-sdk的task_wait函数自动处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在调用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定位问题。
判断轮询终止条件与重试策略
轮询不是无休止的，必须设定明确的退出逻辑，否则可能陷入死循环或超时阻塞。
从 JSON 配置构建 sessions_spawn 命令负载。适用于需要可复用的子代理配置（模型/思考/超时/清理/agentId/标签）等场景。
方法一：按状态值终止。只要收到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异常，需捕获处理。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
