{"record":{"id":"57eb895b3a7858a4","repo":"xtekky/gpt4free","slug":"response-response-status-code-cloudflare-detect","errorCode":null,"errorMessage":"Response {response.status_code}: Cloudflare detected","messagePattern":"Response (.+?): Cloudflare detected","errorType":"exception","errorClass":"CloudflareError","httpStatus":403,"severity":"error","filePath":"g4f/requests/raise_for_status.py","lineNumber":110,"sourceCode":"    if hasattr(response, \"status\"):\n        return raise_for_status_async(response, message)\n    if response.ok:\n        return\n    is_html = False\n    if message is None:\n        is_html = response.headers.get(\"content-type\", \"\").startswith(\n            \"text/html\"\n        ) or response.text.startswith(\"<!DOCTYPE\")\n        message = response.text\n    if message is None or is_html:\n        if response.status_code == 520:\n            message = \"Unknown error (Cloudflare)\"\n    if response.status_code in (429, 402):\n        raise RateLimitError(f\"Response {response.status_code}: {message}\")\n    if response.status_code == 401:\n        raise MissingAuthError(f\"Response {response.status_code}: {message}\")\n    if response.status_code == 403 and is_cloudflare(response.text):\n        raise CloudflareError(f\"Response {response.status_code}: Cloudflare detected\")\n    elif response.status_code == 403 and is_openai(response.text):\n        raise MissingAuthError(f\"Response {response.status_code}: OpenAI Bot detected\")\n    elif response.status_code == 502:\n        raise ResponseStatusError(f\"Response {response.status_code}: Bad Gateway\")\n    elif response.status_code == 504:\n        raise RateLimitError(f\"Response {response.status_code}: Gateway Timeout \")\n    elif response.status_code == 400 and \"API key not valid\" in message:\n        raise MissingAuthError(f\"Response {response.status_code}: Invalid API key\")\n    else:\n        raise ResponseStatusError(\n            f\"Response {response.status_code}: {'HTML content' if is_html else message}\"\n        )\n","sourceCodeStart":92,"sourceCodeEnd":123,"githubUrl":"https://github.com/xtekky/gpt4free/blob/973504e1770928ed5fb82f43da528f441ad9ddc3/g4f/requests/raise_for_status.py#L92-L123","documentation":"Sync variant of the Cloudflare branch: 403 plus a body matching is_cloudflare (checked against response.text) raises CloudflareError. The provider's Cloudflare bot-protection page intercepted the requests-based call.","triggerScenarios":"Synchronous g4f HTTP calls to providers behind Cloudflare that serve a challenge/block page (cf-spinner, 'Just a moment...', 'Attention Required!') with 403.","commonSituations":"Cloudflare rules tightened for the provider; flagged datacenter IP; plain requests TLS fingerprint detected as a bot.","solutions":["Retry from a different IP or network.","Use g4f providers that drive a real browser (install g4f[webdrivers] extras).","Switch providers.","Update g4f for the latest Cloudflare workarounds."],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":"from g4f.errors import CloudflareError\ndef is_cloudflare_block(err: BaseException) -> bool:\n    return isinstance(err, CloudflareError)","tryCatchPattern":"from g4f.errors import CloudflareError\ntry:\n    resp = g4f.ChatCompletion.create(model, messages)\nexcept CloudflareError:\n    resp = g4f.ChatCompletion.create(other_model, messages)  # different provider","preventionTips":["Rotate providers on Cloudflare blocks","Keep g4f current","Prefer API providers over web-scraped ones in production","Don't immediately retry the blocked provider"],"tags":["cloudflare","http-403","bot-protection","sync"],"backgroundTag":null,"analyzedSha":"973504e1770928ed5fb82f43da528f441ad9ddc3","analyzedAt":"2026-08-14T23:45:32.408Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}