コンテンツへスキップ
/
デバッグガイド
最終更新

デバッグガイド

  1. 無効な TaskId エラー
    理由: タスクが保持期間を超えると、それ以降のステータスチェックは InvalidTaskId エラーを返します。これを避けるには、AI タスクを開始した後に Webhook を設定するかポーリングを実装し、success または error のいずれかの終端状態に達するまでステータスを監視します。
    解決策: タスクの有効期限切れを防ぐには、保持期間内に一定間隔でタスクステータスを確認するポーリングループを実装します。

  2. AI API 使用時の 404 Not Found エラー
    A: 重要: File API を呼び出すだけではファイルはアップロードされません。File API のレスポンスで提供された URL にファイルをアップロードする必要があります。その URL がアップロード先です。続行する前に、ファイルがそこに正常に転送されたことを確認します。
    AI API を呼び出す前に、ファイルが正常にアップロードされたことを確認します。File API でアップロード URL を取得し、その場所へファイルをアップロードします。アップロードが完了すると、レスポンスで file_id が返されます。この ID を使用して、そのファイルに関連する AI 機能にアクセスします。

  3. API レスポンスが Postman で同じスタイル ID を返す
    A: Postman（Pretty view）と Chrome が JavaScript で JSON レスポンスを解析するためです。JavaScript では、9007199254740991（2^53-1）を超える数は正確に表現できず、最も近い値に丸められるため、異なる ID が同一に見えることがあります（例: 219691778809271815 → 219691778809271800）。

    • JavaScript/JSON エラー処理における精度の損失
      • 原因: JavaScript の Number 型は 2^53 - 1 を超える整数を安全に処理できないため、切り詰めまたは丸めが発生します。
      • 解決策: json-bigint のような JSON パーサーを使用して ID を文字列として扱い、完全な精度を保持します。

  4. Beard 認証 400 エラー
    A: V2 API を使用する場合は、Bearer 認証ヘッダーを追加してすべてのリクエストに API キーを含めます。 有効なリクエストヘッダー形式

    Authorization: Bearer YOUR_API_KEY

    よくある問題

    1. Bearer プレフィックスの欠落 Authorization ヘッダーは Bearer で始まり、その後に API キーが続く必要があります。 例:

      Authorization: YOUR_API_KEY

    2. 不要な文字 API キーの周りに角括弧 < や > を含めません。これらの文字は不要で、リクエストが失敗します。 例:

      Authorization: Bearer <YOUR_API_KEY>

    3. 誤った API キー Authorization ヘッダーの API キーが正しいことを確認します。

FAQ