BerriAI/litellm · error · BlackForestLabsError

BFL initial request failed: {initial_response.text}

Error message

BFL initial request failed: {initial_response.text}

What it means

Error "BFL initial request failed: {initial_response.text}" thrown in BerriAI/litellm.

Source

Thrown at litellm/llms/black_forest_labs/image_edit/handler.py:307

        timeout: float | httpx.Timeout | None = None,
    ) -> httpx.Response:
        """
        Poll BFL API until result is ready (sync version).

        Args:
            initial_response: The initial response containing polling_url
            headers: Headers to use for polling (must include x-key)
            sync_client: HTTP client
            max_wait: Maximum time to wait in seconds
            interval: Polling interval in seconds
            timeout: Timeout for each individual polling request

        Returns:
            Final response with completed result
        """
        # Validate initial response status code
        if initial_response.status_code >= 400:
            raise BlackForestLabsError(
                status_code=initial_response.status_code,
                message=f"BFL initial request failed: {initial_response.text}",
            )

        # Parse initial response to get polling URL
        try:
            response_data: Final = initial_response.json()
        except Exception as e:
            raise BlackForestLabsError(
                status_code=initial_response.status_code,
                message=f"Error parsing initial response: {e}",
            )

        # Check for immediate errors
        if "errors" in response_data:
            raise BlackForestLabsError(
                status_code=initial_response.status_code,
                message=f"BFL error: {response_data['errors']}",

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Inspect the BFL error response text; check API key and request parameters.

When it happens

Trigger: Thrown at litellm/llms/black_forest_labs/image_edit/handler.py:307 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@6c2dcb801b (2026-08-15). Data as JSON: /api/errors/d54ff6118a248cc6. Report an issue: GitHub.