BerriAI/litellm · error · MinimaxException

URL output format is not yet supported. Use 'hex' format or

Error message

URL output format is not yet supported. Use 'hex' format or fetch from URL: {audio_url}

What it means

Error "URL output format is not yet supported. Use 'hex' format or fetch from URL: {audio_url}" thrown in BerriAI/litellm.

Source

Thrown at litellm/llms/minimax/text_to_speech/transformation.py:329

            if status is not None and status != 0:
                ced: Final = response_json.get("ced", "Unknown error")
                error_detail: Final = ced if ced else f"API returned status {status}"
                raise MinimaxException(
                    status_code=raw_response.status_code,
                    message=f"MiniMax TTS error: {error_detail}",
                    headers=dict(raw_response.headers),
                )

            # Extract audio data
            # MiniMax returns audio in "data" field
            data: Final = response_json.get("data", {})

            # Check if response contains a URL (output_format='url')
            audio_url: Final = data.get("audio_url", None)
            if audio_url:
                # If URL format is used, we need to fetch the audio from the URL
                # For now, return a response indicating URL mode (TODO: fetch audio from URL)
                raise MinimaxException(
                    status_code=500,
                    message=f"URL output format is not yet supported. Use 'hex' format or fetch from URL: {audio_url}",
                    headers=dict(raw_response.headers),
                )

            # Get hex-encoded audio data
            audio_hex: Final = data.get("audio", "") or response_json.get("audio_file", "")

            if not audio_hex:
                raise MinimaxException(
                    status_code=500,
                    message=f"No audio data in MiniMax response. Response keys: {list(response_json.keys())}",
                    headers=dict(raw_response.headers),
                )

            # MiniMax returns hex-encoded audio by default
            # Try hex decoding first, fall back to base64 if that fails
            try:

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Use 'hex' output format or fetch the audio from the returned URL.

When it happens

Trigger: Thrown at litellm/llms/minimax/text_to_speech/transformation.py:329 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/b87f3bdfaf52216d. Report an issue: GitHub.