BerriAI/litellm · error · VertexAIError

Error reading GCS bucket response: {e}

Error message

Error reading GCS bucket response: {e}

What it means

Parsing the GCS bucket XML/JSON response into GcsBucketResponse failed (unexpected schema or malformed body) while transforming the file-upload result; the underlying exception is wrapped for diagnosis.

Source

Thrown at litellm/llms/vertex_ai/files/transformation.py:848

            return extracted_file_data_content
        raise ValueError("Unsupported file content type")

    def transform_create_file_response(
        self,
        model: str | None,
        raw_response: Response,
        logging_obj: LiteLLMLoggingObj,
        litellm_params: dict,
    ) -> OpenAIFileObject:
        """
        Transform VertexAI File upload response into OpenAI-style FileObject
        """
        response_json: Final[GcsBucketResponse] = raw_response.json()

        try:
            response_object: Final = GcsBucketResponse(**response_json)
        except Exception as e:
            raise VertexAIError(
                status_code=raw_response.status_code,
                message=f"Error reading GCS bucket response: {e}",
                headers=raw_response.headers,
            )

        gcs_id = response_object.get("id", "")
        # Remove the last numeric ID from the path
        gcs_id = "/".join(gcs_id.split("/")[:-1]) if gcs_id else ""

        return OpenAIFileObject(
            purpose=response_object.get("purpose", "batch"),
            id=f"gs://{gcs_id}",
            filename=response_object.get("name", ""),
            created_at=_convert_vertex_datetime_to_openai_datetime(
                vertex_datetime=response_object.get("timeCreated", "")
            ),
            status="uploaded",
            bytes=int(response_object.get("size", 0)),

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Inspect exception e; check GCS bucket permissions and object existence.
2. Verify credentials have storage access.

Example fix

# test bucket access with the same service account via gsutil.

When it happens

Trigger: Triggered when reading the GCS bucket response during a Vertex AI files operation raises an exception.

Common situations: See trigger scenarios.

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