# デバッグガイド

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 キーが正しいことを確認します。