← Přehled / ai-search / troubleshooting

Chybové kódy API

Když požadavek na API AI Search nebo veřejný endpoint selže, vrátí jednu z chyb popsaných na této stránce.

Chyby, které nastanou během indexování položky, se řeší samostatně. Viz Chybové kódy indexování.

REST API a veřejné endpointy vracejí chyby v obálce JSON:

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

Workers binding vyvolává výjimky. Vlastnost výjimky message obsahuje chybovou zprávu AI Search, například ai_search_not_found.

U volání přes vazbu Workers závisí vyvolaná třída chyby na stavovém kódu HTTP nadřazené služby:

Tyto chyby se mohou vyskytnout u většiny cest API AI Search.

Tyto chyby se mohou vyskytnout, když prostřednictvím REST API nebo vazby Workers vytváříte, čtete, aktualizujete, mažete instance AI Search nebo získáváte jejich statistiky.

Tyto chyby se mohou vyskytnout, když přidáváte, měníte nebo odebíráte vlastní doména na veřejném endpointu instance nebo jmenného prostoru.

Kód 7096 se také vrací jako ai_gateway_credential_not_found když požadavek volá poskytovatel modelu bez uloženého přihlašovacího údaje. Použijte message je pole, které slouží k jejich rozlišení.

Tyto chyby se mohou vyskytnout, když vytváříte, vypisujete, čtete, aktualizujete nebo mažete jmenné prostory, nebo když mezi jmennými prostory přesouváte instance.

Tyto chyby se mohou vyskytnout, když vytváříte, vypisujete, čtete, aktualizujete nebo mažete servisní tokeny API pro AI Search.

Tyto chyby se mohou vyskytnout, když prostřednictvím Items API nebo vazby Workers nahráváte, vypisujete, čtete, stahujete, mažete, synchronizujete, filtrujete nebo kontrolujete indexované položky.

Tyto chyby se mohou vyskytnout, když prostřednictvím REST API nebo vazby Workers vytváříte, vypisujete, čtete nebo rušíte synchronizační úlohy, nebo vypisujete jejich protokoly.

Tyto chyby se mohou vyskytnout, když spouštíte vyhledávání v instanci, vyhledávání napříč instancemi, vyhledávání přes veřejný endpoint nebo instance.search() přes REST API, Workers binding nebo public endpointy.

Tyto chyby se mohou vyskytnout, když AI Search načítá kontext a generuje odpověď prostřednictvím chat completions v rámci instance, napříč instancemi nebo přes veřejný endpoint, nebo instance.chatCompletions().

Tyto chyby se mohou vyskytnout, když používáte vyhledávání nebo chat mezi instancemi a dotazovat tak více instancí v jednom požadavku.

Když return_on_failure je povoleno, může vyhledávání napříč instancemi vracet částečné výsledky s errors: [{ instance_id, message: "search_failed" }]. Tato odpověď nepoužívá číselný kód chyby.

Tyto chyby se mohou vyskytnout, když požadavek na vyhledávání nebo chat volá Workers AI, AI Gateway nebo externího poskytovatele modelu.

Kód 7096 se také vrací, když Deaktivace výchozího hostitelského názvu bez vlastní domény. Použijte message je pole, které slouží k jejich rozlišení.

Tyto chyby se mohou vyskytnout, když dojde k selhání veřejného vyhledávání, veřejných chat completions, Model Context Protocol (MCP), analytiky úryvků, assetů nebo směrování veřejného endpointu, ještě než je požadavek přesměrován na AI Search. Veřejný endpoint /search a /chat/completions může také vracet chyby AI Search API uvedené výše.

Pokud se požadavek API nezdaří, zkontrolujte code a message pole v chybové odpovědi. U volání přes Workers binding zkontrolujte vyhozenou chybu name a message.

U přechodných chyb služby to zkuste znovu s exponenciální prodlevou. Pokud interní chyba nebo chyba služby přetrvává, kontaktování podpory Cloudflare s kódem chyby, ID instance a časovým razítkem požadavku.