mirror of
https://github.com/BerriAI/litellm.git
synced 2026-09-09 22:31:41 +00:00
* test: drop the cwd-relative sys.path.insert calls from the test suite
TQ003 stands at 1,077 across 1,058 files, and 1,015 of them are the same shape:
sys.path.insert(0, os.path.abspath("../..")) and its deeper siblings. The
argument resolves against the working directory rather than the file, so from
the repo root, where every job runs pytest, it inserts the directory two levels
above the checkout. It has never pointed at litellm. The package is installed
into the environment anyway, which is what actually makes the import work, and
what the rule's message has said all along.
Removing them leaves 1,634 imports of sys and os with no remaining reference,
and those go too, except where another test module imports the name back out of
the file. The rest of TQ003 is 62 call sites that resolve against __file__ or a
variable, which are a different question and are left alone.
Collection is identical either way: 45,871 tests and the same 51 pre-existing
collection errors before and after, and ruff reports no new undefined name.
* test: drop the duplicate imports the sys.path sweep exposed to F811
* test(pre-call-utils): restore the os import the new bedrock tests need
419 lines
15 KiB
Python
419 lines
15 KiB
Python
"""
|
|
Test Gemini TTS (Text-to-Speech) functionality
|
|
"""
|
|
|
|
import pytest
|
|
from unittest.mock import patch, MagicMock
|
|
|
|
|
|
import litellm
|
|
from litellm.llms.gemini.chat.transformation import GoogleAIStudioGeminiConfig
|
|
from litellm.utils import get_supported_openai_params
|
|
|
|
|
|
class TestGeminiTTSTransformation:
|
|
"""Test Gemini TTS transformation functionality"""
|
|
|
|
def test_gemini_tts_model_detection(self):
|
|
"""Test that TTS models are correctly identified"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
# Test TTS models (both preview and non-preview versions)
|
|
assert (
|
|
config.is_model_gemini_audio_model("gemini-2.5-flash-preview-tts") == True
|
|
)
|
|
assert config.is_model_gemini_audio_model("gemini-2.5-pro-preview-tts") == True
|
|
assert config.is_model_gemini_audio_model("gemini-2.5-flash-tts") == True
|
|
assert config.is_model_gemini_audio_model("gemini-2.5-pro-tts") == True
|
|
|
|
# Test non-TTS models
|
|
assert config.is_model_gemini_audio_model("gemini-2.5-flash") == False
|
|
assert config.is_model_gemini_audio_model("gemini-2.5-pro") == False
|
|
assert config.is_model_gemini_audio_model("gpt-4o-audio-preview") == False
|
|
|
|
def test_gemini_tts_supported_params(self):
|
|
"""Test that audio parameter is included for TTS models"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
# Test TTS model
|
|
params = config.get_supported_openai_params("gemini-2.5-flash-preview-tts")
|
|
assert "audio" in params
|
|
|
|
# Test that other standard params are still included
|
|
assert "temperature" in params
|
|
assert "max_tokens" in params
|
|
assert "modalities" in params
|
|
|
|
# Test non-TTS model
|
|
params_non_tts = config.get_supported_openai_params("gemini-2.5-flash")
|
|
assert "audio" not in params_non_tts
|
|
|
|
def test_gemini_tts_audio_parameter_mapping(self):
|
|
"""Test audio parameter mapping for TTS models"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
non_default_params = {"audio": {"voice": "Kore", "format": "pcm16"}}
|
|
optional_params = {}
|
|
|
|
result = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
# Check speech config is created
|
|
assert "speechConfig" in result
|
|
assert "voiceConfig" in result["speechConfig"]
|
|
assert "prebuiltVoiceConfig" in result["speechConfig"]["voiceConfig"]
|
|
assert (
|
|
result["speechConfig"]["voiceConfig"]["prebuiltVoiceConfig"]["voiceName"]
|
|
== "Kore"
|
|
)
|
|
|
|
# Check response modalities
|
|
assert "responseModalities" in result
|
|
assert "AUDIO" in result["responseModalities"]
|
|
|
|
def test_gemini_tts_audio_parameter_mapping_with_language_code(self):
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
non_default_params = {
|
|
"audio": {"voice": "Kore", "format": "pcm16", "language_code": "en-US"}
|
|
}
|
|
optional_params = {}
|
|
|
|
result = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
assert "speechConfig" in result
|
|
assert result["speechConfig"]["languageCode"] == "en-US"
|
|
assert (
|
|
result["speechConfig"]["voiceConfig"]["prebuiltVoiceConfig"]["voiceName"]
|
|
== "Kore"
|
|
)
|
|
|
|
def test_map_audio_params_language_code(self):
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
result = config._map_audio_params(
|
|
{"voice": "Kore", "format": "pcm16", "language_code": "de-DE"}
|
|
)
|
|
|
|
assert result["languageCode"] == "de-DE"
|
|
assert result["voiceConfig"]["prebuiltVoiceConfig"]["voiceName"] == "Kore"
|
|
|
|
def test_map_audio_params_no_language_code(self):
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
result = config._map_audio_params({"voice": "Kore", "format": "pcm16"})
|
|
|
|
assert "languageCode" not in result
|
|
assert result["voiceConfig"]["prebuiltVoiceConfig"]["voiceName"] == "Kore"
|
|
|
|
def test_gemini_tts_audio_parameter_with_existing_modalities(self):
|
|
"""Test audio parameter mapping when modalities already exist"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
non_default_params = {"audio": {"voice": "Puck", "format": "pcm16"}}
|
|
optional_params = {"responseModalities": ["TEXT"]}
|
|
|
|
result = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
# Check that AUDIO is added to existing modalities
|
|
assert "responseModalities" in result
|
|
assert "TEXT" in result["responseModalities"]
|
|
assert "AUDIO" in result["responseModalities"]
|
|
|
|
def test_gemini_tts_no_audio_parameter(self):
|
|
"""Test that non-audio parameters are handled normally"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
non_default_params = {"temperature": 0.7, "max_tokens": 100}
|
|
optional_params = {}
|
|
|
|
result = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
# Should not have speech config
|
|
assert "speechConfig" not in result
|
|
# Should not automatically add audio modalities
|
|
assert "responseModalities" not in result
|
|
|
|
def test_gemini_tts_invalid_audio_parameter(self):
|
|
"""Test handling of invalid audio parameter"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
non_default_params = {"audio": "invalid_string"} # Should be dict
|
|
optional_params = {}
|
|
|
|
result = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
# Should not create speech config for invalid audio param
|
|
assert "speechConfig" not in result
|
|
|
|
def test_gemini_tts_empty_audio_parameter(self):
|
|
"""Test handling of empty audio parameter"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
non_default_params = {"audio": {}}
|
|
optional_params = {}
|
|
|
|
result = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
# Should still set response modalities even with empty audio config
|
|
assert "responseModalities" in result
|
|
assert "AUDIO" in result["responseModalities"]
|
|
|
|
def test_gemini_tts_audio_format_validation(self):
|
|
"""Test audio format validation for TTS models"""
|
|
config = GoogleAIStudioGeminiConfig()
|
|
|
|
# Test invalid format
|
|
non_default_params = {
|
|
"audio": {"voice": "Kore", "format": "wav"} # Invalid format
|
|
}
|
|
optional_params = {}
|
|
|
|
with pytest.raises(
|
|
ValueError, match="Unsupported audio format for Gemini TTS models"
|
|
):
|
|
config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model="gemini-2.5-flash-preview-tts",
|
|
drop_params=False,
|
|
)
|
|
|
|
def test_gemini_tts_utils_integration(self):
|
|
"""Test integration with LiteLLM utils functions"""
|
|
# Test that get_supported_openai_params works with TTS models
|
|
params = get_supported_openai_params("gemini-2.5-flash-preview-tts", "gemini")
|
|
assert "audio" in params
|
|
|
|
# Test non-TTS model
|
|
params_non_tts = get_supported_openai_params("gemini-2.5-flash", "gemini")
|
|
assert "audio" not in params_non_tts
|
|
|
|
|
|
def test_gemini_tts_completion_mock():
|
|
"""Test Gemini TTS completion with mocked response"""
|
|
with patch("litellm.completion") as mock_completion:
|
|
# Mock a successful TTS response
|
|
mock_response = MagicMock()
|
|
mock_response.choices = [MagicMock()]
|
|
mock_response.choices[0].message.content = "Generated audio response"
|
|
mock_completion.return_value = mock_response
|
|
|
|
# Test completion call with audio parameter
|
|
response = litellm.completion(
|
|
model="gemini-2.5-flash-preview-tts",
|
|
messages=[{"role": "user", "content": "Say hello"}],
|
|
audio={"voice": "Kore", "format": "pcm16"},
|
|
)
|
|
|
|
assert response is not None
|
|
assert response.choices[0].message.content is not None
|
|
|
|
|
|
class TestGeminiTTSSpeechConfigInRequestBody:
|
|
"""Test that speechConfig is properly included in the final request body.
|
|
|
|
This tests the full transformation pipeline, not just map_openai_params().
|
|
Previously, speechConfig was created but filtered out because it was missing
|
|
from the GenerationConfig TypedDict.
|
|
"""
|
|
|
|
@pytest.mark.parametrize(
|
|
"model,custom_llm_provider",
|
|
[
|
|
("gemini-2.5-flash-tts", "vertex_ai"),
|
|
("gemini-2.5-flash-tts", "gemini"),
|
|
("gemini-2.5-flash-preview-tts", "vertex_ai"),
|
|
("gemini-2.5-flash-preview-tts", "gemini"),
|
|
("gemini-2.5-pro-tts", "vertex_ai"),
|
|
],
|
|
)
|
|
def test_speechconfig_in_generation_config_transform_request_body(
|
|
self, model, custom_llm_provider
|
|
):
|
|
"""Test that speechConfig is included in generationConfig after _transform_request_body()"""
|
|
from litellm.llms.vertex_ai.gemini.transformation import (
|
|
_transform_request_body,
|
|
)
|
|
|
|
# Simulate optional_params after map_openai_params() has run
|
|
optional_params = {
|
|
"speechConfig": {
|
|
"voiceConfig": {"prebuiltVoiceConfig": {"voiceName": "Kore"}}
|
|
},
|
|
"responseModalities": ["AUDIO"],
|
|
}
|
|
|
|
messages = [{"role": "user", "content": "Say hello"}]
|
|
|
|
# Call _transform_request_body which applies the filtering
|
|
request_body = _transform_request_body(
|
|
messages=messages,
|
|
model=model,
|
|
optional_params=optional_params,
|
|
custom_llm_provider=custom_llm_provider,
|
|
litellm_params={},
|
|
cached_content=None,
|
|
)
|
|
|
|
# Verify speechConfig is in generationConfig (not filtered out)
|
|
assert "generationConfig" in request_body
|
|
generation_config = request_body["generationConfig"]
|
|
assert "speechConfig" in generation_config, (
|
|
f"speechConfig was filtered out of generationConfig for model={model}, provider={custom_llm_provider}. "
|
|
"Ensure speechConfig is in the GenerationConfig TypedDict."
|
|
)
|
|
assert (
|
|
generation_config["speechConfig"]["voiceConfig"]["prebuiltVoiceConfig"][
|
|
"voiceName"
|
|
]
|
|
== "Kore"
|
|
)
|
|
|
|
@pytest.mark.parametrize(
|
|
"model,custom_llm_provider",
|
|
[
|
|
("gemini-2.5-flash-tts", "vertex_ai"),
|
|
("gemini-2.5-flash-tts", "gemini"),
|
|
("gemini-2.5-flash-preview-tts", "vertex_ai"),
|
|
],
|
|
)
|
|
def test_speechconfig_end_to_end_mapping(self, model, custom_llm_provider):
|
|
"""Test full pipeline: audio param -> map_openai_params -> _transform_request_body"""
|
|
from litellm.llms.vertex_ai.gemini.vertex_and_google_ai_studio_gemini import (
|
|
VertexGeminiConfig,
|
|
)
|
|
from litellm.llms.vertex_ai.gemini.transformation import (
|
|
_transform_request_body,
|
|
)
|
|
|
|
config = VertexGeminiConfig()
|
|
|
|
# Step 1: Map OpenAI audio param to speechConfig
|
|
non_default_params = {"audio": {"voice": "Puck", "format": "pcm16"}}
|
|
optional_params = {}
|
|
|
|
mapped_params = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model=model,
|
|
drop_params=False,
|
|
)
|
|
|
|
# Verify map_openai_params creates speechConfig
|
|
assert "speechConfig" in mapped_params
|
|
|
|
messages = [{"role": "user", "content": "Hello world"}]
|
|
|
|
# Step 2: Transform to request body (this is where the bug was)
|
|
request_body = _transform_request_body(
|
|
messages=messages,
|
|
model=model,
|
|
optional_params=mapped_params,
|
|
custom_llm_provider=custom_llm_provider,
|
|
litellm_params={},
|
|
cached_content=None,
|
|
)
|
|
|
|
# Verify speechConfig survives the transformation
|
|
assert "generationConfig" in request_body
|
|
generation_config = request_body["generationConfig"]
|
|
assert "speechConfig" in generation_config, (
|
|
f"speechConfig was filtered out during _transform_request_body() for model={model}, provider={custom_llm_provider}. "
|
|
"This breaks Gemini TTS - speechConfig must be in GenerationConfig TypedDict."
|
|
)
|
|
assert (
|
|
generation_config["speechConfig"]["voiceConfig"]["prebuiltVoiceConfig"][
|
|
"voiceName"
|
|
]
|
|
== "Puck"
|
|
)
|
|
|
|
# Also verify responseModalities is present
|
|
assert "responseModalities" in generation_config
|
|
assert "AUDIO" in generation_config["responseModalities"]
|
|
|
|
|
|
@pytest.mark.parametrize(
|
|
"model,custom_llm_provider",
|
|
[
|
|
("gemini-2.5-flash-tts", "vertex_ai"),
|
|
("gemini-2.5-flash-tts", "gemini"),
|
|
("gemini-2.5-flash-preview-tts", "vertex_ai"),
|
|
],
|
|
)
|
|
def test_language_code_end_to_end_mapping(self, model, custom_llm_provider):
|
|
from litellm.llms.vertex_ai.gemini.vertex_and_google_ai_studio_gemini import (
|
|
VertexGeminiConfig,
|
|
)
|
|
from litellm.llms.vertex_ai.gemini.transformation import (
|
|
_transform_request_body,
|
|
)
|
|
|
|
config = VertexGeminiConfig()
|
|
|
|
non_default_params = {
|
|
"audio": {"voice": "Puck", "format": "pcm16", "language_code": "pt-BR"}
|
|
}
|
|
optional_params = {}
|
|
|
|
mapped_params = config.map_openai_params(
|
|
non_default_params=non_default_params,
|
|
optional_params=optional_params,
|
|
model=model,
|
|
drop_params=False,
|
|
)
|
|
|
|
assert mapped_params["speechConfig"]["languageCode"] == "pt-BR"
|
|
|
|
request_body = _transform_request_body(
|
|
messages=[{"role": "user", "content": "Hello world"}],
|
|
model=model,
|
|
optional_params=mapped_params,
|
|
custom_llm_provider=custom_llm_provider,
|
|
litellm_params={},
|
|
cached_content=None,
|
|
)
|
|
|
|
generation_config = request_body["generationConfig"]
|
|
assert generation_config["speechConfig"]["languageCode"] == "pt-BR"
|
|
assert (
|
|
generation_config["speechConfig"]["voiceConfig"]["prebuiltVoiceConfig"][
|
|
"voiceName"
|
|
]
|
|
== "Puck"
|
|
)
|
|
assert "AUDIO" in generation_config["responseModalities"]
|
|
|
|
|
|
if __name__ == "__main__":
|
|
pytest.main([__file__])
|