· reAPI Team
Kie AI 任务状态:卡在 99%,还是仍在处理?
当生成停在 99% 时,了解如何读取 Kie AI 任务状态。在决定是否再次提交前,检查原始任务、结果、回调和点数记录。

进度条已经到了 99%,视频却还没有出现。在再次点击生成之前,先找到第一次尝试的任务 ID:这样就可以分清,你是在等视频生成,还是在等应用发现视频其实已经存在。
Kie AI 任务状态来自任务记录。对于 Market 作业,这份记录会区分等待、生成、成功和失败,并在状态旁携带结果或错误信息。[1] 单凭一个百分比,无法替你决定下一步。先检查现有任务,再沿着响应确实支持的分支处理。
找到进度条对应的任务
打开最初提交时收到的响应。如果你使用的是 Kie 的 Market API,找到返回的 taskId。查询接口是 GET /api/v1/jobs/recordInfo?taskId=...,用于获取通过 POST /api/v1/jobs/createTask 创建的作业。其他端点系列需要查阅各自的文档。例如,同步聊天请求不会产生可轮询的 Market 任务。[2][1]
如果你使用网站,文档说明可以在 Kie 的 Logs 区域找到已提交的任务、参数和结果。[3] 如果使用自动化流程,就检查提交节点的输出。从那里复制 ID,而不是从后续重试中复制:即使提示词相同,两次提交仍然是需要分别跟踪的两次尝试。
对于你自己的应用,应将提供商 ID 与客户任务的关联标识一同保存。假设有一篇名为 friday-demo 的定时帖子,视频仍在等待完成。计划名称告诉你视频的用途;提供商 ID 告诉你应该获取哪次生成。这是建议的记录结构,并非 Kie 的功能。同时保留两者,就能重启工作进程,而不必重新执行内容生成任务。
完全没有任务 ID?先返回提交日志,再考虑修改提示词。响应丢失意味着第一次提交的结果尚不明确。你需要通过可用的账户历史记录或客服确认它是否已被接受,之后才能判断第二次提交是不是一次无害的重试。
先读取响应,再修改工作流
在查看任务状态之前,需要做两项检查。先检查 HTTP 响应,再检查 JSON 的 code。Kie 的任务参考文档说明,HTTP 200 响应内部也可能包含业务错误,包括凭证无效,以及任务 ID 缺失、不存在或属于其他账户。文档也列出了 HTTP 错误响应。只处理其中一种形式,就会留下缺口。[1]
当工作流看起来卡住时,这一点很重要。如果轮询器不断收到查询错误,但屏幕仍显示上一次的进度值,再盯着百分比看一分钟,也无法知道任务究竟在做什么。将 ID 和账户与最初的提交进行比对。保存错误响应体,但不要保存 API 密钥。先修复查询,再诊断生成问题。
查询成功后,读取 data.state:
waiting和queuing表示任务正在队列中等待。generating表示正在处理。success表示可以检查返回的结果。fail表示应检查failCode和failMsg。
这些是 Market API 文档中列出的状态。[1] 客户端应单独处理无法识别的值;悄悄把它当作失败,会将一个你尚不理解的响应变成再次生成的理由。
下面的解码器会区分这些情况。它处理的是你的服务器已经获取的响应,其中不包含提交或自动重试。
function inspectMarketTask(httpStatus, body) {
if (httpStatus < 200 || httpStatus >= 300) {
return { kind: 'lookup_error', httpStatus };
}
if (body?.code !== 200 || !body.data) {
return { kind: 'lookup_error', code: body?.code, message: body?.msg };
}
const task = body.data;
if (['waiting', 'queuing', 'generating'].includes(task.state)) {
return { kind: 'pending', taskId: task.taskId, state: task.state };
}
if (task.state === 'fail') {
return {
kind: 'failed', taskId: task.taskId,
code: task.failCode, message: task.failMsg,
credits: task.creditsConsumed,
};
}
if (task.state !== 'success') {
return { kind: 'unknown_state', taskId: task.taskId, state: task.state };
}
let result;
try { result = JSON.parse(task.resultJson); }
catch { return { kind: 'result_unreadable', taskId: task.taskId }; }
const urls = result?.resultUrls;
if (!Array.isArray(urls) || !urls.length ||
urls.some(url => typeof url !== 'string' || !url.trim())) {
return { kind: 'output_missing', taskId: task.taskId };
}
return { kind: 'ready', taskId: task.taskId, urls };
}kind 标签属于这个示例。输出检查适用于解析后的 resultJson 包含 resultUrls 的媒体作业,并不覆盖所有模型的输出。文本模型和主体检测模型使用不同的结构。[1] 即使是 ready,也只表示预期的 URL 字符串存在。接下来仍需要下载并检查实际文件。
如果任务成功,沿着文件链路检查
对于成功的媒体作业,将 resultJson 解析为 JSON,再查找预期的 URL。该字段是 JSON 字符串,因此像读取对象一样读取 task.resultJson.resultUrls,无法取得文档所述的数组。[1]
接着从响应往下检查。是否包含预期的媒体字段?服务器能否下载该 URL?存储步骤是否保存了文件字节?页面是否指向保存的文件?每一个答案都能缩小恢复位置的范围。如果上传到你自己的存储失败,只要源文件仍然可用,就应该重试上传,而不是再购买一次生成。
例如,假设日志显示任务成功,随后归档上传失败。这是一个假设的排障案例。将成功任务的 ID 保留在作业记录中,必要时重新获取结果,然后从归档步骤恢复。如果改为从工作流的第一个节点重新运行,就会在没有解决存储失败的情况下,把同一个创作请求再次送去生成。
及时保存有用的输出。Kie 首页列出的媒体保留期为 14 天,但 Market 参考文档为 OmniHuman 1.5 Subject Detection 描述的 URL 有效期为一小时。这个特定模型的例外很重要。[3][1] 一条成功的任务记录,与一个永久可下载的文件,并不是一回事。将下载的文件、原始 ID 和响应保存在一起,以免日后 URL 不再可用时,你也失去关于事情经过的记录。
如果仍在生成,让同一个任务继续完成
Kie 的指南建议在生产环境使用回调,轮询则采用指数退避,初始间隔为两到三秒。指南还说明,有些视频任务会超过十分钟。[1] 这些信息足以否定“十分钟就算失败”这条通用规则,但并不承诺每一个延迟任务最终都会成功。
应用可能在任务停止运行之前就停止等待。定时帖子有截止时间;浏览器会话也需要考虑用户的耐心。应决定自己的等待上限到期后如何处理。一种有用的本地结果是“需要关注”,同时保留任务 ID 以便稍后查询。没有终态响应就将其标为“失败”,会让下一位操作人员误以为生成已经结束,而实际上你只是停止了观察。
如果配置了 callBackUrl,也要检查回调链路。Kie 支持成功和失败任务的通知。其验证方案签名的是任务 ID 和时间戳,而不是整个响应体;指南也引导你回到经过身份验证的任务查询,以获取权威结果。[4]
用通知唤醒现有作业。获取状态后,执行与轮询后相同的完成处理。如果轮询已经取回视频,后续回调应当找到这条本地已完成的作业。设计处理器时,应确保它不会仅仅因为完成消息从另一条路径到达,就再次发布同一篇帖子。
在 n8n 中,从需要处理的步骤恢复
需要检查的是 HTTP Request 节点上的 Retry on Fail 设置。n8n 文档说明,该设置会重试失败的节点。[5] 开启之前,先看清节点内部执行的操作。
查询已知任务的节点可以重复查询。发送生成 POST 的节点则会重复提交。这两种操作不应仅仅因为都使用 HTTP,就采用同样的重试决策。如果较大的工作流将提交、等待和下载包装在一个可重新启动的步骤中,应将已保存的任务 ID 单独取出,让恢复流程能从提交之后进入。
对于上文假设的归档失败,恢复位置是下载或存储节点。对于回调丢失,恢复位置是查询。对于 state: fail,先读取失败原因,再决定是否有必要修改请求。对于结果未知的提交,应在核对第一次尝试期间停止自动重放。
每日视频工作流指南 展示了 reAPI 上一种持久化作业的处理方式。它的 API 字段与 Kie 不同,但有用的设计选择是相同的:保留足够的状态,以便继续未完成的工作,而不重复已完成的工作。
如果任务失败,将错误与扣费记录放在一起
Kie 表示失败任务不收费。任务响应还会提供 creditsConsumed,以及状态、错误字段和时间戳。[3][1] 应针对这一次具体尝试比对这些记录。如果还有多个其他作业同时运行,仅凭总余额变化,无法判断某一个视频发生了什么。
如果已经再次点击生成,调查时应保留两个 ID。第一个任务可能才是进度条对应的任务,而第二个任务可能才是你正在查看的扣费对应的任务。申请账单更正之前,先将每份响应与各自的提交对应起来。
联系客服时,先列出任务 ID 和模型,再提供提交时间及时区、最新响应、错误消息和相关点数记录。说明工作停在哪一步:尚无终态、结果成功但没有可用 URL、下载失败,或看似存在账单不符。Kie 首页将技术问题引导至其支持群组。[3] 分享任何材料前,移除凭证和无关的私密输入。
失败任务政策并不能让本文对某个账户承诺退款。它提供的是一项具体差异,供你请客服解决。如果任务成功,但视频不符合你的要求,应另行描述;质量投诉和记录中的生成失败,是两种不同的支持问题。
更换 API 时,也带上恢复逻辑
如果反复处理恢复问题促使你评估 reAPI,从任务响应开始。普通媒体作业使用 processing、completed 和 failed;结果位于 output 下,usage.credits 表示结算后的消耗。轮询已知任务不会消耗点数。[6] 应明确映射这些字段,而不是原样复用 Kie 的响应解码器。
也有一些限制需要考虑。reAPI 的回调没有签名,因此应通过经过身份验证的查询,验证已知的待处理任务;使用 ?include=webhook 可以获取投递信息。[7] 带着 Idempotency-Key 重复发送生成 POST,并不会对请求去重;部分模型特定的生成后安全检查失败仍会保留扣费。[8][6] 迁移时应保留对已保存尝试记录和结算的检查。
通过模型目录查看需要的模型,通过 Kie 对比考虑更广泛的平台选择问题。无论更换平台还是再发送一次 POST,都无法处理那个已经停在 99% 的视频。对于那个视频,应回到它的任务 ID,从最后一个能够确认结果的步骤继续。
参考资料
- Kie AI。*获取任务详情,Market API。*查阅于 2026 年 11 月 15 日。
- Kie AI。*Market 快速入门与统一 API 结构。*查阅于 2026 年 11 月 15 日。
- Kie AI。*首页常见问题:任务、支持、保留期和试用点数。*查阅于 2026 年 11 月 15 日。
- Kie AI。*Webhook 安全验证。*查阅于 2026 年 11 月 15 日。
- n8n。*HTTP Request 节点常见问题:Retry on Fail。*查阅于 2026 年 11 月 15 日。HTTP Request 故障排查。
- reAPI。*任务。*审阅于 2026 年 11 月 15 日。任务轮询文档。
- reAPI。*Webhook。*审阅于 2026 年 11 月 15 日。投递与验证契约。
- reAPI。*API 概览。*审阅于 2026 年 11 月 15 日。提交与幂等性文档。