← Обзор / ai-search / troubleshooting

Коды ошибок API

Если запрос к API AI Search или к публичной конечной точке завершается ошибкой, возвращается одна из ошибок, описанных на этой странице.

Ошибки, возникающие при индексировании элемента, обрабатываются отдельно. См. Коды ошибок индексации.

REST API и публичные конечные точки возвращают ошибки в виде JSON-конверта:

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

привязка Workers выбрасывает исключения. Свойство исключения message содержит сообщение об ошибке AI Search, например ai_search_not_found.

При вызовах через привязку Workers класс выбрасываемой ошибки зависит от HTTP статуса вышестоящего сервера:

Эти ошибки могут возникать в большинстве путей API AI Search.

Эти ошибки могут возникать при создании, чтении, обновлении, удалении экземпляров AI Search или получении статистики по ним через REST API или привязку Workers.

Эти ошибки могут возникать при добавлении, изменении или удалении пользовательский домен на публичной конечной точке экземпляра или пространства имён.

Код 7096 также возвращается как ai_gateway_credential_not_found когда запрос вызывает провайдер модели без сохранённых учётных данных. Используйте message поле, чтобы различать их.

Эти ошибки могут возникать при создании, получении списка, чтении, обновлении или удалении пространств имён, а также при перемещении экземпляров между пространствами имён.

Эти ошибки могут возникать при создании, получении списка, чтении, обновлении или удалении токенов API службы AI Search.

Эти ошибки могут возникать при загрузке, получении списка, чтении, скачивании, удалении, синхронизации, фильтрации или проверке проиндексированных элементов через Items API или привязку Workers.

Эти ошибки могут возникать при создании, получении списка, чтении, отмене заданий синхронизации или получении списка их логов через REST API или привязку Workers.

Эти ошибки могут возникать при выполнении поиска в экземпляре, поиска между экземплярами, поиска через публичную конечную точку или instance.search() через REST API, Workers binding или public endpoints.

Эти ошибки могут возникать, когда AI Search получает контекст и формирует ответ через chat completions экземпляра, chat completions между экземплярами, chat completions публичной конечной точки или instance.chatCompletions().

Эти ошибки могут возникать при использовании межэкземплярный поиск или чат и таким образом делать запрос сразу к нескольким инстансам за один раз.

Когда return_on_failure включён, поиск между экземплярами может возвращать частичные результаты с errors: [{ instance_id, message: "search_failed" }]. Этот ответ не использует числовой код ошибки.

Эти ошибки могут возникать, если запрос поиска или чата обращается к Workers AI, AI Gateway или стороннему провайдеру модели.

Код 7096 также возвращается, когда отключение имени хоста по умолчанию без пользовательского домена. Используйте message поле, чтобы различать их.

Эти ошибки могут возникать, если запрос не проходит публичный поиск, публичные chat completions, Model Context Protocol (MCP), аналитику сниппетов, assets или маршрутизацию публичной конечной точки ещё до того, как он будет проксирован в AI Search. Публичная конечная точка /search и /chat/completions также может возвращать перечисленные выше ошибки API AI Search.

Если запрос API завершается ошибкой, проверьте code и message поля в ответе об ошибке. Для вызовов через привязку Workers проверьте выброшенную ошибку name и message.

При временных ошибках службы повторяйте запрос с экспоненциальной задержкой. Если внутренняя ошибка или ошибка службы не исчезает, обратитесь в службу поддержки Cloudflare с кодом ошибки, ID экземпляра и временной меткой запроса.