GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
すべてのガイド

· reAPI Team

Kie AI のタスク状態:99%で止まっている? それとも処理中?

生成が99%のまま進まないときのKie AIのタスク状態を確認します。再送信を判断する前に、元のタスク、結果、コールバック、クレジット記録を調べましょう。

Kie AI のタスク状態:99%で止まっている? それとも処理中?

進捗バーは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をコピーします。同じプロンプトで2回送信しても、追跡すべき試行は2つです。

独自のアプリでは、顧客のジョブ参照と並べてプロバイダーのIDを保存してください。friday-demoという予約投稿があり、動画がまだ完了していないとします。予定の名前は動画の用途を示し、プロバイダーのIDは取得すべき生成を示します。これは推奨する記録構造であり、Kieの機能ではありません。両方を保持すれば、制作ジョブをやり直さずにワーカーを再起動できます。

タスクIDがまったくありませんか。プロンプトを変える前に、送信ログに戻ってください。レスポンスが失われた場合、最初の送信結果は未確定のままです。2回目の送信を問題のない再試行とみなす前に、利用できるアカウント履歴やサポートを通じて、最初の送信が受け付けられたかを確認する必要があります。

ワークフローを変更する前にレスポンスを読む

タスクの状態に進む前に、2つの確認があります。まずHTTPレスポンスを調べ、次にJSONのcodeを調べます。Kieのタスクのリファレンスには、認証情報が無効な場合や、タスクIDがない、存在しない、別の所有者に属するといった業務エラーがHTTP 200レスポンス内に含まれることが記載されています。HTTPエラーレスポンスも掲載されています。片方の形式だけを処理すると、抜けが生まれます。[1]

これはワークフローが止まって見えるときに重要です。ポーラーが照会エラーを受け取り続け、画面には直前の進捗値が表示されたままなら、さらに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有効期間は1時間と説明されています。モデル固有の例外は重要です。[3][1] 成功したタスク記録と、永続的にダウンロードできるファイルは別物です。ダウンロードしたファイル、元のID、レスポンスを一緒に保存し、後でURLが使えなくなっても経緯の記録まで失わないようにしてください。

まだ生成中なら、同じタスクの完了を待つ

Kieのガイドは、本番環境ではコールバックを、ポーリングでは2〜3秒間隔から始める指数バックオフを推奨しています。また、一部の動画タスクは10分を超えるとも説明しています。[1] これだけでも「10分経ったら失敗」という一律のルールは否定できます。ただし、遅れているすべてのタスクが最終的に成功するという約束ではありません。

タスクが動作を終える前に、アプリケーションが待機を終えることはあります。予約投稿には期限があり、ブラウザーセッションではユーザーの忍耐も考える必要があります。自分の待機上限を超えたときの動作を決めてください。有用なローカルの結果としては「要確認」があり、後で照会できるようタスクIDを保持します。終端レスポンスがないのに「失敗」と呼ぶと、観測をやめただけなのに、次の担当者は生成が終了したと思ってしまいます。

callBackUrlを設定した場合は、コールバックの経路も確認してください。Kieは成功と失敗のタスク通知に対応しています。その検証方式が署名するのはタスクIDとタイムスタンプで、レスポンス本文全体ではありません。ガイドでも、確定的な結果については認証付きのタスク照会を参照するよう案内しています。[4]

通知を使って既存のジョブを再開してください。状態を取得し、ポーリング後と同じ完了処理を実行します。ポーリングですでに動画を回収していたら、後から来るコールバックは完了済みのローカルジョブを見つけるべきです。別の経路から完了通知が届いただけで、同じ投稿を再公開できないハンドラーにしてください。

n8nでは、作業が必要なステップから再開する

確認する設定はHTTP RequestノードのRetry on Failです。n8nのドキュメントによると、失敗したノードを再試行します。[5] 有効にする前に、そのノード内の操作を確認してください。

既知のタスクを照会するノードは、照会を繰り返せます。生成POSTを送るノードは、送信を繰り返します。どちらもHTTPを使うというだけで、同じ再試行判断にしてはいけません。より大きなワークフローで送信、待機、ダウンロードを1つの再開可能なステップにまとめているなら、保存したタスクIDを切り出し、送信後から復旧に入れるようにしてください。

前述の仮定のアーカイブ失敗なら、再開位置はダウンロードまたは保存ノードです。コールバックが失われた場合は照会です。state: failでは、まず失敗を読み、リクエスト変更が妥当か判断してください。送信結果が不明な場合は、最初の試行を照合している間、自動再実行を止めてください。

日々の動画ワークフローガイドでは、reAPIでの永続的なジョブ管理の方法を紹介しています。APIフィールドはKieと異なりますが、有用な設計判断は同じです。完了した作業を繰り返さず、未完了の作業を続けられるだけの状態を保持します。

失敗していたら、エラーを課金記録と並べて残す

Kieは失敗したタスクには課金しないと説明しています。タスクのレスポンスには、状態、エラーフィールド、タイムスタンプとともにcreditsConsumedも含まれます。[3][1] その試行について、これらの記録を照合してください。ほかの複数のジョブが動いていた場合、全体の残高変化から1本の動画の経緯は特定できません。

すでにもう一度生成をクリックしたなら、調査では両方のIDを残してください。進捗バーが示すのは最初のタスクで、見ている課金は2つ目のタスクのものかもしれません。請求の訂正を求める前に、各レスポンスをそれぞれの送信に対応づけてください。

サポートには、まずタスクIDとモデルを示し、続いて送信日時とタイムゾーン、最新レスポンス、エラーメッセージ、関連するクレジット記録を伝えてください。終端状態がない、成功結果に使えるURLがない、ダウンロード失敗、課金の不一致らしきものなど、作業が止まった場所を説明します。Kieのホームページは、技術的な質問をサポートグループに案内しています。[3] 共有するものから、認証情報と無関係な非公開の入力を取り除いてください。

失敗タスクの方針があっても、この記事が個別アカウントへの返金を約束することはできません。サポートに解決を求める具体的な食い違いが示されます。タスクは成功したものの動画が要件に合わなかった場合は、別に説明してください。品質の苦情と、記録された生成失敗は異なるサポート上の問題です。

APIを変更しても、復旧のロジックは引き継ぐ

復旧作業が繰り返し発生するためreAPIを検討するなら、タスクレスポンスから確認してください。通常のメディアジョブはprocessing、completed、failedを使い、結果はoutputに入り、usage.creditsは精算済みの消費量を示します。既知のタスクのポーリングではクレジットを消費しません。[6] Kie用のレスポンスデコーダーをそのまま再利用せず、フィールドを明示的に対応づけてください。

考慮すべき制限もあります。reAPIのコールバックには署名がないため、既知の未完了タスクを認証付き照会で確認してください。配信情報は?include=webhookで取得できます。[7] Idempotency-Key付きで生成POSTを繰り返しても重複排除はされず、一部のモデル固有の生成後安全性チェックの失敗では課金が残ります。[8][6] 移行時にも、保存した試行と精算の確認を維持してください。

必要なモデルはモデルカタログで、より広い選択の問題はKieの比較で確認してください。プラットフォームの変更も2回目のPOSTも、すでに99%で止まっている動画を解決しません。その動画についてはタスクIDに戻り、結果を確認できる最後のステップから再開してください。

参考文献

  1. Kie AI。*タスク詳細の取得、Market API。*2026年11月15日取得。
  2. Kie AI。*Marketクイックスタートと統一API構造。*2026年11月15日取得。
  3. Kie AI。*ホームページのよくある質問:タスク、サポート、保持期間、試用クレジット。*2026年11月15日取得。
  4. Kie AI。*Webhookのセキュリティ検証。*2026年11月15日取得。
  5. n8n。*HTTP Requestノードのよくある問題:Retry on Fail。*2026年11月15日取得。HTTP Requestのトラブルシューティング。
  6. reAPI。*タスク。*2026年11月15日確認。タスクのポーリングドキュメント。
  7. reAPI。*Webhook。*2026年11月15日確認。配信と検証の契約。
  8. reAPI。*API概要。*2026年11月15日確認。送信と冪等性のドキュメント。
すべてのガイド