📜 ログと非同期タスク
API リクエスト、画像生成、非同期タスクのログを確認し、条件に応じた絞り込みやステータス、実行結果、返金の追跡を行います。
本プラットフォームでは、API リクエストの詳細、画像生成ログ、動画や音声などの長時間非同期タスクを分類して保存しており、開発者が迅速なトラブルシューティング、正確な請求照合、結果のトレーサビリティを行えるようになっています。
コンソールには 3 つの専用ログセクションが用意されています：
/usage-logs/common：一般的な API 呼び出し詳細と Token 課金ログ/usage-logs/drawing：Midjourney 画像生成タスクログと画像結果/usage-logs/task：Suno 音楽や動画などの非同期生成タスクログ
ユーザーログは権限によって厳格に分離されており、一般開発者は現在のアカウントから送信されたリクエストログおよびタスク結果のみを閲覧できます。
使用ログ
左サイドバーで「使用ログ」をクリックするか、直接 /usage-logs/common にアクセスして、API リクエストおよび課金の詳細を確認できます。
ログの絞り込み
| フィルター項目 | 説明 |
|---|---|
| 時間範囲 | リクエスト作成時間で絞り込みます。カスタムの開始日・終了日をサポートしています。 |
| モデル名 | モデルのキーワードを入力し、指定したモデルの呼び出し頻度を素早く特定します。 |
| グループ | リクエストが実際にルーティングされたチャネルグループで絞り込みます。 |
| ログタイプ | すべて、消費、チャージ、エラー、返金などが含まれます。 |
| トークン名 | API キー名で絞り込み、各開発環境の消費量を正確に把握します。 |
| リクエスト ID | プラットフォームが生成した一意の Request ID を入力して単一リクエストを特定します。 |
| 上流リクエスト ID | モデルプロバイダーから返却された元の Request ID を入力します。 |
リアルタイム指標ダッシュボード
フィルターバーの上部には、リアルタイムのスループットと消費指標が表示されます：
- Usage：現在の絞り込み条件における総クォータ消費統計
- RPM（Requests Per Minute）：直近 60 秒間の同時実行リクエストレート
- TPM（Tokens Per Minute）：直近 60 秒間の Token スループットレート（入力 Token + 出力 Token）
リストと詳細
ログリストには、呼び出し日時、モデル、消費クォータ、プロンプト Token、完了 Token、および応答所要時間が直感的に表示されます。個別のログをクリックすると展開され、リクエストヘッダー、詳細なエラー情報、コンテキストスナップショットを確認できます。
画像生成ログ
左サイドバーから /usage-logs/drawing にアクセスし、Midjourney などの画像生成タスクの詳細を確認します。
- プロンプト（Prompt）、送信日時、所要時間、実行進捗、ステータスが表示されます。
- 生成完了後はリスト内で直接画像をプレビューでき、ワンクリックでの高解像度化（Upscale）やバリエーション生成（Variation）などの追加操作にも対応しています。
非同期タスクログ
左サイドバーから /usage-logs/task にアクセスし、動画生成（Sora / Kling / 即夢）、Suno 音楽などの長時間非同期タスクを一元管理・追跡します。
タスクステータスの説明
| ステータス | 詳細な意味 |
|---|---|
| 待機中 / キュー内 | タスクが生成キューに正常に追加され、計算リソースの割り当てを待機しています。 |
| 実行中 | 上流の生成エンジンがレンダリング／生成中であり、進捗パーセンテージを確認できます。 |
| 成功 | タスクが完了しました。コンソールでのプレビューや API 経由でのダウンロードリンク取得が可能です。 |
| 失敗 | 生成に失敗しました。詳細列に上流から返された具体的なエラー理由が表示されます。 |
非同期タスクのステータスは通常、システムバックグラウンドによって 15 秒ごとにポーリング・更新されます。大規模モデルの動画／音声レンダリングには時間がかかるため、ステータスの更新をしばらくお待ちください。
失敗、タイムアウトおよび自動返金
上流サービスの中断やタイムアウトによって非同期タスクが最終的に失敗した場合：
- タスク送信時にクォータが事前差し引きされていた場合、システムは失敗を確認後、事前差し引きされたクォータを自動で全額返金します。
- 返金が完了すると、一般的な使用ログに「返金」明細が自動的に記録され、クォータが元のアカウント残高またはサブスクリプション枠に返還されます。
インターフェースリファレンス
読み取り専用ログクエリ 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) |
エンドポイントは標準的なページネーションパラメータ p（ページ番号、1 から開始）および page_size（1 ページあたりの件数、最大 100）をサポートしています。
非同期生成・タスクエンドポイント
| インターフェースタイプ | パス | 機能説明 |
|---|---|---|
| 動画生成 | POST /v1/videos | 非同期動画生成タスクを送信し、task_id を返します。 |
| 動画タスククエリ | GET /v1/videos/{task_id} | 生成進捗と結果の URL を取得します。 |
| 動画ストリーミング取得 | GET /v1/videos/{task_id}/content | 生成された動画のバイナリコンテンツをプロキシ経由でストリーミング取得します。 |
| Kling テキストからの動画生成 | POST /kling/v1/videos/text2video | Kling プロトコルの Text-to-Video タスクを送信します。 |
| Kling 画像からの動画生成 | POST /kling/v1/videos/image2video | Kling プロトコルの Image-to-Video タスクを送信します。 |
| Suno 音楽タスク | POST /suno/submit/{action} | Suno 音楽作成タスクを送信します。 |
| Suno ステータスクエリ | GET /suno/fetch/{id} | 生成された音声の再生アドレスと歌詞を取得します。 |
| Midjourney タスク | POST /mj/submit/{action} | Imagine、Blend、Describe などのタスクを送信します。 |
| Midjourney クエリ | GET /mj/task/{id}/fetch | Midjourney タスクステータスと画像結果を取得します。 |
データダッシュボードとの関係
- ログ：各呼び出しのミリ秒単位の所要時間、エラー、正確な Token 数を含む、リクエストごとの生履歴データです。
- データダッシュボード：時間周期（日／週／月）、モデルタイプ、API キーごとに集計されたマクロなトレンドチャートです。
- 推奨事項：個別の呼び出しエラーや課金の疑問が生じた場合は、まず「使用ログ」で Request ID をもとに調査・特定してください。全体的な使用量やモデル選定コストを評価する場合は、「データダッシュボード」をご参照ください。
このドキュメントは役に立ちましたか？