BerriAI/litellm · error · TimeoutError

Azure Document Intelligence operation polling timed out…

Error message

Azure Document Intelligence operation polling timed out after {timeout_secs} seconds

What it means

Error "Azure Document Intelligence operation polling timed out after {timeout_secs} seconds" thrown in BerriAI/litellm.

Solutions

1. Increase the polling timeout, or check the operation status in the Azure portal; analysis did not finish in time.

When it happens

Trigger: Thrown at litellm/llms/azure_ai/ocr/document_intelligence/transformation.py:444 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/2ba553215165a6d5. Report an issue: GitHub.

Appendix: source

Thrown at litellm/llms/azure_ai/ocr/document_intelligence/transformation.py:444

            width_px = int(width)
            height_px = int(height)

        return OCRPageDimensions(width=width_px, height=height_px, dpi=dpi)

    @staticmethod
    def _check_timeout(start_time: float, timeout_secs: int) -> None:
        """
        Check if operation has timed out.

        Args:
            start_time: Start time of the operation
            timeout_secs: Timeout duration in seconds

        Raises:
            TimeoutError: If operation has exceeded timeout
        """
        if time.time() - start_time > timeout_secs:
            raise TimeoutError(f"Azure Document Intelligence operation polling timed out after {timeout_secs} seconds")

    @staticmethod
    def _get_retry_after(response: httpx.Response) -> int:
        """
        Get retry-after duration from response headers.

        Args:
            response: HTTP response

        Returns:
            Retry-after duration in seconds (default: 2)
        """
        retry_after: Final = int(response.headers.get("retry-after", "2"))
        verbose_logger.debug("Retry polling after: %s seconds", retry_after)
        return retry_after

    @staticmethod
    def _check_operation_status(response: httpx.Response) -> str:

View on GitHub (pinned to 77b7c6c40c)