详情

首页手游攻略 MiniMax Agent API查询任务进度做法

MiniMax Agent API查询任务进度做法

佚名 2026-08-16 20:41:55

必须通过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异常,需捕获处理。

相关资讯
点击查看更多
游戏推荐
推荐专题
热门阅读
推荐下载