ログと非同期タスク

プラットフォームは、リクエストの明細、描画の記録、動画や音楽などの非同期タスクをそれぞれ別に保存します。ログイン後、左側ナビゲーションから「利用ログ」または「タスクログ」を開けます。このページでは 3 つのデータ区分、タスクの状態、API での照会方法をまとめて説明します。

3 つの区分は次のパスに対応します。

/usage-logs/common: 汎用 API の利用ログと課金内訳
/usage-logs/drawing: Midjourney の描画タスク
/usage-logs/task: Suno や動画などの汎用非同期タスク

利用ログ

左サイドバーで「利用ログ」をクリックするか /usage-logs/common にアクセスすると、API リクエストと課金内訳を確認できます。

絞り込み

絞り込み項目	説明
期間	記録の作成時刻で絞り込みます。開始と終了の両方が照会範囲に含まれます。
モデル名	モデル名で絞り込みます。
グループ	リクエストが使用したグループで絞り込みます。
ログ種別	すべて、チャージ、消費、管理、システム、エラー、返金、ログイン。
トークン名	API キー名で絞り込みます。
リクエスト ID	プラットフォームのリクエスト ID で 1 件を特定します。
上流リクエスト ID	上流サービスが返したリクエスト ID で特定します。問い合わせ時にこの ID を添えると調査が大幅に速くなります。

ページ上の統計

絞り込みバーの統計値は、現在の絞り込み条件に連動します。

Usage: 現在の絞り込み範囲にある消費記録のクォータ合計。時刻、モデル、グループ、キーなどの条件で確認できます。
RPM: 直近 60 秒間の消費リクエスト数。
TPM: 直近 60 秒間の入力トークンと出力トークンの合計。

一覧と詳細

一覧には時刻と種別、トークン、モデル、ストリーム、トークン数、費用、所要時間、詳細の列があります。

トークン: 入力トークン / 出力トークンを表示します。キャッシュを使った場合は、キャッシュの読み取り数と書き込み数も表示されることがあります。
費用: その記録のクォータ消費または返金結果を表示します。
所要時間: 計測データがある消費またはエラー記録に応答時間を表示します。ストリーミングでは初回応答時間（FRT）やスループット情報が追加で表示されることがあります。
詳細: 記録をクリックすると詳細ダイアログが開きます。ログ種別と実際に保存されたフィールドに応じて、リクエスト ID、モデルマッピング、エラーや返金の理由、トークン内訳、課金内訳、キャッシュ／音声／画像の利用量、ストリーム状態などが含まれます。すべてのブロックが常に表示されるわけではありません。

記録が見当たらない場合

ログの書き込みにはわずかな遅れがあります。送ったばかりのリクエストは数秒後に現れるため、まずページを更新してから判断してください。

失敗した応答がすべて Error 記録になるわけではありません。モデルに到達する前に弾かれたケース（キーが無効、クォータ不足など）は、通常そもそも消費ログを作りません。

プロフィールの「IP アドレスを記録する」設定は、消費ログとエラーログにリクエスト IP を保存するかどうかだけを制御し、記録そのものが作られるかどうかには影響しません。

タスクログ

「タスクログ」には「描画ログ」と「タスクログ」の 2 つのサブ区分があります。

描画ログ: Midjourney の描画タスクを記録します。
タスクログ: テキストから動画、画像から動画、音声生成などの非同期タスクを記録します。

描画ログ

左サイドバーで「タスクログ」→「描画ログ」をクリックするか /usage-logs/drawing にアクセスすると、Midjourney の描画タスク記録を確認できます。

描画ログは次の条件で絞り込めます。

期間
Midjourney のタスク ID

一覧には、送信時刻と状態、操作種別、タスク ID、所要時間、送信結果、進捗、画像、プロンプト、失敗理由が含まれます。画像をクリックするとプレビューが開き、プロンプトをクリックすると全文を確認でき、失敗理由をクリックすると完全なエラー情報を確認できます。

描画の状態は、未開始、キュー中、実行中、成功、失敗、ウィンドウ待機です。

非同期タスクログ

左サイドバーで「タスクログ」→「タスクログ」をクリックするか /usage-logs/task にアクセスすると、非同期タスクログを確認できます。

動画や音楽などの非同期 API は、リクエスト送信時に最終結果を返しません。送信に成功すると、プラットフォームは公開用のタスク ID を返してタスク記録を保存し、その後バックグラウンドが上流サービスをポーリングして状態、進捗、結果を更新します。

タスクの絞り込み

タスクログは次の条件で絞り込めます。

期間
タスク ID

一覧と結果

タスク一覧には、送信時刻と完了時刻、タスク ID、プラットフォームと操作、所要時間、状態、進捗、詳細が表示されます。

Suno のタスクが成功して音声アドレスを返した場合、詳細列で音声をプレビューできます。
一部の動画タスクは成功後にプレビューの入口が表示されます。同じアカウントのログインセッションまたは API キーで /v1/videos/{task_id}/content にリクエストして、完了したタスクの動画コンテンツを取得することもできます。この API はタスクの所有者を検証し、タスクが未完了の場合や他のユーザーのものである場合は内容を返しません。
その他の失敗記録は詳細列に失敗理由が表示され、クリックすると完全な情報を確認できます。

タスクの状態とバックグラウンド処理

非同期タスクログでは次の状態値を使います。プラットフォームによって状態の表記が少し異なることがあるため、API 経由で読むときは幅を持たせて扱ってください。

状態	意味
未開始	タスク記録は作成済みだが、処理はまだ始まっていない。
キュー中	上流に送信済みで、後続の処理を待っている。
待機列	処理キューに入っている。
実行中	処理中。
成功	完了し、結果を確認・取得できる。
失敗	処理に失敗。上流が理由を返した場合はタスク記録に書き込まれる。
不明	内部で定義した不明状態のフォールバック値。

タスクの状態はバックグラウンドのポーリングで約 15 秒ごとに更新されるため、送信直後はわずかに遅れます。API で結果を確認する場合も、この間隔に合わせてポーリングしてください。高頻度のループでのリクエストは避けてください。いつまでも完了しないタスクは、タイムアウト後に失敗の終了状態へ移ります。

失敗、タイムアウト、返金

タスクが失敗の終了状態になると、送信段階で前もって差し引かれたクォータがある場合、システムは通常返金を試み、返金に成功すると「返金」ログを 1 件書き込みます。返金に成功すると、タスク記録の返金待ちクォータが消去され、累計利用量が差し引かれます。リクエスト回数は戻りません。

次の場合、ページの状態と残高が一時的に一致しないことがあります。

タスクにもともと前もって差し引かれたクォータがない（費用が 0 と表示される）
返金がまだ通っておらず、再試行や手動照合のためにシステムがクォータを保持している。この場合はタスク ID を控えてサポートにご連絡ください

API リファレンス

ログ照会 API

利用状況を自前の照合システムや監視に取り込みたい場合は、次の読み取り専用 API を利用できます。ログインセッションで認証し、返る結果は常に自分のアカウントに限定されます。

データ	API	時刻パラメーターの単位
汎用ログ	`GET /api/log/self`	秒（`created_at`）
ログ統計	`GET /api/log/self/stat`	秒
Midjourney 描画	`GET /api/mj/self`	ミリ秒（`submit_time`）
非同期タスク	`GET /api/task/self`	秒（`submit_time`）

これらの API はページングパラメーター p と page_size を使います。ページ番号は 1 から始まり、100 を超える page_size は 100 に切り詰められます。

また GET /api/log/token は、ログインセッションなしで API キー自体を使い、そのキーの最近のログを読み取れます。サーバー側での利用量チェックに向いています。最大で直近 1000 件を返し、キーが期限切れでもクォータ切れでも照会できます。

GET /api/task/self でよく使うクエリパラメーター: p、page_size、task_id、start_timestamp、end_timestamp。platform、action、status も受け付けます。

タスク API の start_timestamp と end_timestamp は Unix 秒のタイムスタンプです。Midjourney 描画 API の時刻パラメーターはミリ秒です。

非同期生成とタスク API

以下の API は、動画・音楽・描画などの非同期タスクの送信と照会に使います。いずれも API キーで認証します。動画コンテンツの API はログインセッションにも対応し、タスクの所有者を検証するため、自分のタスクの内容だけが返ります。

どのプラットフォームが使えるかは、現在提供されているモデルによって決まります。モデルマーケットでモデル種別を絞り込んで確認してください。

エンドポイント	パス	説明
OpenAI 動画生成	`POST /v1/videos`	OpenAI 互換の動画生成非同期タスクを作成し、成功するとタスク識別子を返します。
OpenAI 動画タスク照会	`GET /v1/videos/{task_id}`	動画生成タスクの状態、進捗、結果を照会します。
動画コンテンツ取得	`GET /v1/videos/{task_id}/content`	完了した動画コンテンツをストリームで返します。タスク結果に従って上流から取得するか、保存済みの data URL をデコードします。
動画リミックス	`POST /v1/videos/{video_id}/remix`	既存の動画を基に新しいリミックスの非同期タスクを送信します。
旧動画生成	`POST /v1/video/generations`	旧来の動画生成パスに対応し、非同期動画タスクを作成します。
旧動画タスク照会	`GET /v1/video/generations/{task_id}`	旧来の動画生成タスクの状態と結果を照会します。
Kling テキストから動画	`POST /kling/v1/videos/text2video`	Kling 形式でテキストから動画を生成するタスクを送信します。システムがまずリクエスト形式を変換します。
Kling 画像から動画	`POST /kling/v1/videos/image2video`	Kling 形式で画像から動画を生成するタスクを送信します。
Kling タスク照会	`GET /kling/v1/videos/text2video/{task_id}` `GET /kling/v1/videos/image2video/{task_id}`	Kling のテキストから動画、または画像から動画のタスク結果を照会します。
Jimeng 公式 API	`POST /jimeng/`	Jimeng 公式 API 形式に対応し、`Action` や `Version` などのパラメーターでタスク送信と照会を区別します。
Suno タスク送信	`POST /suno/submit/{action}`	Suno の音楽生成タスクを送信します。タスク種別は `action` パラメーターで決まります。
Suno タスク照会	`POST /suno/fetch` `GET /suno/fetch/{id}`	Suno のタスク一覧、または指定タスクの状態と結果を照会します。
Midjourney タスク送信	`POST /mj/submit/{action}` `POST /{mode}/mj/submit/{action}`	`imagine`、`describe`、`blend`、`change`、`simple-change`、`edits`、`video`、`action`、`modal`、`shorten` などの操作に対応します。
Midjourney タスク照会	`GET /mj/task/{id}/fetch` `GET /mj/task/{id}/image-seed` `POST /mj/task/list-by-condition`	タスクの状態、画像シード、条件によるタスク一覧を照会します。`{mode}` プレフィックス付きのパスにも対応します。
Midjourney 画像プロキシ	`GET /mj/image/{id}` `GET /{mode}/mj/image/{id}`	Midjourney のタスク ID から生成画像を取得またはプロキシします。
Midjourney 拡張操作	`POST /mj/insight-face/swap` `POST /mj/submit/upload-discord-images`	顔の入れ替えや Discord 画像のアップロードなどの拡張機能を提供します。

ダッシュボードとの関係

ログは 1 件ずつの明細で、ダッシュボードは時刻・モデル・グループごとに集計した統計です。更新のタイミングが違うため、新しいリクエストはまずログに現れ、グラフは集計後に反映されます。短時間なら両者の数字が合わなくても異常ではありません。

呼び出しを調べるときは、まず利用ログで時刻、モデル、Request ID、Upstream Request ID からリクエストを特定してください。非同期リクエストの場合は、送信 API が返した task_id を記録し、タスクの最終状態と失敗の詳細を照会します。サポートに連絡する際は、リクエスト ID かタスク ID を添えるのがいちばん早道です。