API エラーコード

AI Search API または公開エンドポイントへのリクエストが失敗すると、このページに記載のいずれかのエラーが返ります。

アイテムのインデックス作成中に起きるエラーは別扱いです。インデックス作成のエラーコード を参照してください。

REST API と公開エンドポイントは、JSON エンベロープでエラーを返します。

{
	"success": false,
	"errors": [
		{
			"code": 7002,
			"message": "ai_search_not_found"
		}
	],
	"result": {}
}

Workers バインディング は例外を投げます。例外の message には、ai_search_not_found など AI Search のエラーメッセージが含まれます。

Workers バインディングの呼び出しでは、投げられるエラークラスは上流の HTTP ステータスに依存します。

これらのエラーは、ほとんどの AI Search API パスで発生することがあります。

これらのエラーは、REST API または Workers バインディングで AI Search インスタンスを作成、読み取り、更新、削除、または統計取得するときに発生することがあります。

これらのエラーは、インスタンスまたは名前空間の公開エンドポイントで カスタムドメイン を追加、変更、削除するときに発生することがあります。

コード 7096 は、保存済み資格情報なしで モデルプロバイダー を呼んだときにも ai_gateway_credential_not_found として返ります。両者の区別には message フィールドを使ってください。

これらのエラーは、名前空間の作成、一覧、読み取り、更新、削除、または名前空間間でのインスタンス移動のときに発生することがあります。

これらのエラーは、AI Search のサービス API トークンを作成、一覧、読み取り、更新、削除するときに発生することがあります。

これらのエラーは、Items API または Workers バインディングで、インデックス済みアイテムのアップロード、一覧、読み取り、ダウンロード、削除、同期、フィルタ、検査をするときに発生することがあります。

これらのエラーは、REST API または Workers バインディングで同期ジョブの作成、一覧、読み取り、キャンセル、またはログ一覧をするときに発生することがあります。

これらのエラーは、REST API、Workers バインディング、または公開エンドポイントで、インスタンス検索、インスタンス横断検索、公開エンドポイント検索、または instance.search() を実行するときに発生することがあります。

これらのエラーは、インスタンスの chat completions、インスタンス横断の chat completions、公開エンドポイントの chat completions、または instance.chatCompletions() で、AI Search がコンテキストを取得して応答を生成するときに発生することがあります。

これらのエラーは、1 回のリクエストで複数インスタンスをクエリする インスタンス横断の検索またはチャット を使うときに発生することがあります。

return_on_failure が有効なとき、インスタンス横断検索は errors: [{ instance_id, message: "search_failed" }] 付きの部分結果を返すことがあります。このレスポンスは数値のエラーコードを使いません。

これらのエラーは、検索またはチャットリクエストが Workers AI、AI Gateway、または外部モデルプロバイダーを呼ぶときに発生することがあります。

コード 7096 は、カスタムドメインなしで デフォルトのホスト名をオフにした ときにも返ります。両者の区別には message フィールドを使ってください。

これらのエラーは、公開検索、公開 chat completions、Model Context Protocol（MCP）、スニペット分析、アセット、または公開エンドポイントのルーティングが、リクエストを AI Search へプロキシする前に失敗したときに発生することがあります。公開エンドポイントの /search と /chat/completions は、上に挙げた AI Search API エラーも返すことがあります。

API リクエストが失敗したら、エラーレスポンスの code と message フィールドを確認してください。Workers バインディングの呼び出しでは、投げられたエラーの name と message を確認してください。

一時的なサービスエラーでは、指数バックオフで再試行してください。内部エラーまたはサービスエラーが続く場合は、エラーコード、インスタンス ID、リクエスト時刻を添えて Cloudflare サポートへ問い合わせて ください。