簡単な回答
API呼び出しをトラブルシューティングする際は、まずモデル名、エンドポイント、呼び出し時刻を記録してください。次に、HTTPレスポンスヘッダーでx-request-idまたはrequest-idを確認してください。エンドポイントがエラーレスポンスを返した場合は、レスポンスのJSONボディでrequest_idなどの識別子も確認し、APIYIログで見つかるフィールドを使用してください。
WanおよびHappyHorseの動画エンドポイントは、レスポンスボディにrequest_idも返します。同じレスポンス内のtask_idは動画タスクの照会に使用するもので、Request IDとは異なります。SeedanceやVeoなどの非同期エンドポイントが返すidまたはtask_idも、動画タスクIDです。
APIYIのログページでは、「リクエストID / アップストリームリクエストID / 完了ID」フィルターに表示される識別子を検索できます。コンソールでログの詳細を開き、ユーザーから提供された識別子を使用して検索してください。
まずは次の3ステップから始めます
1
ステップ1:モデルとエンドポイントを確認する
完全なモデル名と実際のURLを記録します。テキストモデルでは通常
/v1/chat/completions、埋め込みモデルでは/v1/embeddings、画像モデルでは/v1/images/generations、動画モデルでは/v1/videosまたはモデル固有の非同期エンドポイントを使用します。2
ステップ2:呼び出し時刻を記録する
リクエストを送信した時刻を記録し、2026-08-25 14:32 (UTC+8)のようにタイムゾーンを含めます。リクエストを再試行した場合は、各再試行のおおよその時刻を記録します。
3
ステップ3:レスポンスとログの詳細を保存する
HTTPステータスコード、完全なレスポンスヘッダー、完全なレスポンスボディ、クライアント例外を保存します。その後、APIYIの「ログ」ページを開き、リクエストID、アップストリームリクエストID、または完了IDで検索します。
API タイプ別のリクエスト ID の確認場所
コードで確認
Python
cURL
-iを使用して、応答ヘッダーと応答本文の両方を出力します。ヘッダー内のx-request-idまたはrequest-idを確認してください。
コンソールログを検索
1
呼び出しログを開く
APIYI コンソールにサインインし、「ログ」を開いて、調査する呼び出しの詳細を開きます。
2
利用可能な識別子を入力する
識別子を「リクエストID / 上流リクエストID / 完了ID」フィルターに貼り付けます。APIYI のレスポンスヘッダーにあるリクエストIDを優先し、利用できない場合は上流リクエストIDまたは完了IDを試します。
3
詳細を比較する
モデル、呼び出し時刻、エンドポイント、チャネル、HTTPステータス、エラーコード、課金記録を比較して、リクエストが APIYI に到達したか、上流プロバイダーに到達したか、リクエストを変更した後に再試行すべきかを判断します。
リクエストIDがないのはなぜですか?
HTTPレスポンスを受信する前にリクエストが失敗した場合(DNS解決、TCP/TLS接続の確立、ローカルプロキシによる拒否、クライアント側の接続タイムアウトなど)、APIYIはレスポンスヘッダーを返す機会がありません。その場合、クライアントが利用できるリクエストIDはありません。 代わりに、以下の情報を提供してください。- 元のクライアント例外と完全なスタックトレース
- リクエスト時刻とタイムゾーン
- モデルとエンドポイント
- HTTPクライアント、プロキシ、またはネットワーク環境
- 利用可能な場合は、成功した呼び出しまたは再試行した呼び出しのリクエストID
サポートに提供する情報
- リクエスト ID
- ログに表示されている場合は、上流リクエスト ID または完了 ID
- モデル名とエンドポイント
- タイムゾーン付きの呼び出し時刻
- HTTP ステータス、完全なレスポンスボディ、クライアント例外
- マスキング済みリクエスト、ならびにコンソールログに表示されたエラーコードと課金ステータス】【。
関連ドキュメント
モデルエラーのトラブルシューティング方法
パラメータ、グループ、タイムアウト、モデルエラーのトラブルシューティング
呼び出しログの表示方法
コンソールでAPI呼び出し、エラー、課金の詳細を表示
ログクエリAPI
時間、モデル、またはrequest_idで呼び出しログを検索
画像APIのベストプラクティス
画像のタイムアウト、切断、課金、リクエストIDのトラブルシューティング