Skip to main content

簡単な回答

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 の確認場所

HTTP ヘッダー名では大文字と小文字は区別されませんが、フィールド名の区切り文字は重要です。x-request-idrequest-idrequest_id は異なる表記です。1 つのフィールド名だけを検索するのではなく、レスポンスヘッダーとエラーボディの両方を確認してください。

コードで確認

Python

cURL

-iを使用して、応答ヘッダーと応答本文の両方を出力します。ヘッダー内のx-request-idまたはrequest-idを確認してください。
WanまたはHappyHorseの動画呼び出しでは、本文の2つのフィールドも保存します。

コンソールログを検索

1

呼び出しログを開く

APIYI コンソールにサインインし、「ログ」を開いて、調査する呼び出しの詳細を開きます。
2

利用可能な識別子を入力する

識別子を「リクエストID / 上流リクエストID / 完了ID」フィルターに貼り付けます。APIYI のレスポンスヘッダーにあるリクエストIDを優先し、利用できない場合は上流リクエストIDまたは完了IDを試します。
3

詳細を比較する

モデル、呼び出し時刻、エンドポイント、チャネル、HTTPステータス、エラーコード、課金記録を比較して、リクエストが APIYI に到達したか、上流プロバイダーに到達したか、リクエストを変更した後に再試行すべきかを判断します。
ユーザーが障害発生時刻のおおよその時間しか把握していない場合でも、モデル、エンドポイント、時刻で検索範囲を絞り込めます。通常、リクエストIDを使うと、単一の呼び出しをはるかに速く特定できます。

リクエストIDがないのはなぜですか?

HTTPレスポンスを受信する前にリクエストが失敗した場合(DNS解決、TCP/TLS接続の確立、ローカルプロキシによる拒否、クライアント側の接続タイムアウトなど)、APIYIはレスポンスヘッダーを返す機会がありません。その場合、クライアントが利用できるリクエストIDはありません。 代わりに、以下の情報を提供してください。
  • 元のクライアント例外と完全なスタックトレース
  • リクエスト時刻とタイムゾーン
  • モデルとエンドポイント
  • HTTPクライアント、プロキシ、またはネットワーク環境
  • 利用可能な場合は、成功した呼び出しまたは再試行した呼び出しのリクエストID
トラブルシューティング用の資料に完全なAPIキーを送信しないでください。キーの中央部分をマスクし、個人情報や、業務上の完全なコンテンツまたは画像を含むリクエストボディを公開しないでください。

サポートに提供する情報

  • リクエスト ID
  • ログに表示されている場合は、上流リクエスト ID または完了 ID
  • モデル名とエンドポイント
  • タイムゾーン付きの呼び出し時刻
  • HTTP ステータス、完全なレスポンスボディ、クライアント例外
  • マスキング済みリクエスト、ならびにコンソールログに表示されたエラーコードと課金ステータス】【。

関連ドキュメント

モデルエラーのトラブルシューティング方法

パラメータ、グループ、タイムアウト、モデルエラーのトラブルシューティング

呼び出しログの表示方法

コンソールでAPI呼び出し、エラー、課金の詳細を表示

ログクエリAPI

時間、モデル、またはrequest_idで呼び出しログを検索

画像APIのベストプラクティス

画像のタイムアウト、切断、課金、リクエストIDのトラブルシューティング