Cesar GarciaandGitHub d30c25af21 feat(gemini): use responseJsonSchema for Gemini 2.0+ models (#19314) ...

* feat(gemini): add opt-in support for responseJsonSchema

Add support for Gemini's native responseJsonSchema parameter which uses
standard JSON Schema format instead of OpenAPI-style responseSchema.

Benefits of responseJsonSchema (Gemini 2.0+ only):
- Standard JSON Schema format (lowercase types)
- Supports additionalProperties for stricter validation
- Better compatibility with Pydantic's model_json_schema()
- No propertyOrdering required

Usage:
```python
response_format={
    "type": "json_schema",
    "json_schema": {"schema": {...}},
    "use_json_schema": True  # opt-in
}
```

This is backwards compatible - existing code continues to use
responseSchema by default.

Closes #16340

* docs: add documentation for use_json_schema parameter

Document the new use_json_schema option for Gemini 2.0+ models
in the JSON Mode documentation.

* refactor(gemini): use responseJsonSchema by default for Gemini 2.0+

Remove opt-in flag `use_json_schema` and automatically detect model version:
- Gemini 2.0+: uses responseJsonSchema (standard JSON Schema, supports additionalProperties)
- Gemini 1.5: uses responseSchema (OpenAPI format, legacy)

This follows LiteLLM's philosophy of abstracting provider differences -
users write the same code regardless of model version.

* test(vertex): update json_schema tests to accept both responseSchema formats

Gemini 2.x+ uses responseJsonSchema while Gemini 1.x uses responseSchema.
Update tests to accept both formats since litellm now auto-selects based
on model version.

2026-01-19 10:45:37 -08:00

..

.litellm_cache

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

auto_router

[Feat] Backend Router - Add Auto-Router powered by semantic-router (#12955)

2025-07-24 18:32:56 -07:00

example_config_yaml

fix tests

2025-10-25 10:19:24 -07:00

test_configs

fix tests

2025-10-25 10:19:24 -07:00

test_model_response_typing

LiteLLM Minor Fixes & Improvements (11/05/2024) (#6590)

2024-11-07 04:17:05 +05:30

adroit-crow-413218-bc47f303efc9.json

vertex testing use pathrise-convert-1606954137718

2025-01-05 14:00:17 -08:00

azure_fine_tune.jsonl

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

azure_speech.mp3

[Feat] Add Azure AVA TTS integration (#15749)

2025-10-20 16:52:23 -07:00

batch_job_results_furniture.jsonl

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

cache_unit_tests.py

fix: use fastuuid helper (#14903)

2025-09-25 15:47:01 -07:00

conftest.py

[Perf] Improvements for Async Success Handler (Logging Callbacks) - Approx +130 RPS (#13905)

2025-08-23 13:13:23 -07:00

create_mock_standard_logging_payload.py

[Bug Fix]: Errors in LiteLLM When Using Embeddings Model with Usage-Based Routing (#7390)

2024-12-23 17:42:24 -08:00

data_map.txt

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

eagle.wav

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

example.jsonl

VertexAI non-jsonl file storage support (#9781)

2025-04-09 14:01:48 -07:00

gettysburg.wav

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

large_text.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

model_cost.json

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

openai_batch_completions_router.jsonl

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

openai_batch_completions.jsonl

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

speech_vertex.mp3

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

stream_chunk_testdata.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_acompletion_fallbacks.py

(core sdk fix) - fix fallbacks stuck in infinite loop (#7751)

2025-01-13 19:34:34 -08:00

test_acompletion.py

Complete o3 model support (#8183)

2025-02-02 22:36:37 -08:00

test_acooldowns_router.py

fix tests

2025-10-25 10:19:24 -07:00

test_add_function_to_prompt.py

LiteLLM Minor Fixes & Improvements (11/05/2024) (#6590)

2024-11-07 04:17:05 +05:30

test_add_update_models.py

fix: use fastuuid helper (#14903)

2025-09-25 15:47:01 -07:00

test_aim_guardrails.py

Fix aim security guardrail tests (#17499)

2025-12-04 13:29:20 -08:00

test_alangfuse.py

Fix CI: Revert security scan changes and add GitGuardian ignore rules (#18358)

2025-12-22 17:03:53 -08:00

test_amazing_vertex_completion.py

feat(gemini): use responseJsonSchema for Gemini 2.0+ models (#19314)

2026-01-19 10:45:37 -08:00

test_anthropic_prompt_caching.py

remove prompt caching headers as the support has been removed

2026-01-02 11:08:35 +05:30

test_arize_ai.py

feat: allow configuring project name for OpenTelemetry service name

2026-01-07 14:20:10 +09:00

test_arize_phoenix.py

ArizePhoenixConfig

2025-11-22 09:28:37 -08:00

test_assistants.py

_add_azure_related_dynamic_params

2025-10-25 11:11:36 -07:00

test_async_fn.py

test_completion_cost_databricks_embedding

2025-10-25 11:47:03 -07:00

test_auth_utils.py

fix(proxy): extract model from vertex ai passthrough url pattern (#18097)

2025-12-17 11:10:14 +05:30

test_azure_content_safety.py

(refactor) caching use LLMCachingHandler for async_get_cache and set_cache (#6208)

2024-10-14 16:34:01 +05:30

test_azure_openai.py

test_aaaaazure_tenant_id_auth

2025-10-25 12:26:06 -07:00

test_azure_perf.py

fix tests

2025-10-25 10:19:24 -07:00

test_basic_python_version.py

test_package_dependencies

2025-11-22 11:20:40 -08:00

test_batch_completion_return_exceptions.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_batch_completions.py

test fix: gcp deprecated gemini-1.5-flash

2025-08-06 08:43:45 -07:00

test_blocked_user_list.py

(docs) add docstrings for all /key, /user, /team, /customer endpoints (#6804)

2024-11-18 19:44:06 -08:00

test_braintrust.py

[Performance] Improve LiteLLM Python SDK RPS by +200 RPS (#13839)

2025-08-20 21:46:33 -07:00

test_budget_manager.py

Litellm ruff linting enforcement (#5992)

2024-10-01 19:44:20 -04:00

test_caching_handler.py

Add support for caching for responses API

2026-01-14 13:33:07 +05:30

test_caching_ssl.py

fix tests

2025-10-25 10:19:24 -07:00

test_caching.py

fix: mark test_caching_with_reasoning_content as flaky and handle InternalServerError (#17603)

2025-12-06 09:41:09 -08:00

test_class.py

fix tests

2025-10-25 10:19:24 -07:00

test_completion_cost.py

Fix CI: Revert security scan changes and add GitGuardian ignore rules (#18358)

2025-12-22 17:03:53 -08:00

test_completion_with_retries.py

Add retry policy support to responses API

2026-01-14 14:55:17 +05:30

test_completion.py

test_completion_bedrock_titan_null_response

2026-01-07 15:09:44 +05:30

test_config.py

fix tests

2025-10-25 10:19:24 -07:00

test_cost_calc.py

test(test_cost_calc.py): fix test to handle llm api errors

2024-12-24 16:49:02 -08:00

test_custom_api_logger.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_custom_callback_input.py

claude-sonnet-4-5-20250929 fix

2025-10-31 18:20:52 -07:00

test_custom_llm.py

feat(custom_llm): add image_edit and aimage_edit support (#17999)

2025-12-15 14:16:36 -08:00

test_custom_logger.py

Adjusted based on comments

2025-11-07 15:02:41 -08:00

test_disk_cache_unit_tests.py

LiteLLM Minor Fixes & Improvements (11/12/2024) (#6705)

2024-11-12 22:50:51 +05:30

test_dual_cache.py

fix: use fastuuid helper (#14903)

2025-09-25 15:47:01 -07:00

test_dynamic_rate_limit_handler.py

fix: use fastuuid helper (#14903)

2025-09-25 15:47:01 -07:00

test_dynamodb_logs.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_embedding.py

test: remove flaky azure oidc embedding test

2026-01-13 10:34:01 +09:00

test_exceptions.py

Fix CI: Revert security scan changes and add GitGuardian ignore rules (#18358)

2025-12-22 17:03:53 -08:00

test_file_types.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_function_call_parsing.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_function_calling.py

fix img URL for tests

2025-11-22 09:41:15 -08:00

test_function_setup.py

Add test for removal of thought signature

2025-12-23 14:56:42 +05:30

test_gcs_bucket.py

Fix CI: Revert security scan changes and add GitGuardian ignore rules (#18358)

2025-12-22 17:03:53 -08:00

test_gcs_cache_unit_tests.py

Add GCS bucket caching support (#13122)

2025-08-04 16:09:33 -07:00

test_gemini_reasoning_content.py

Add thought signature for non tool call requests

2026-01-02 12:31:31 +05:30

test_get_llm_provider.py

fix: test_default_api_base for ragfow

2025-12-04 21:49:33 +05:30

test_get_model_file.py

LiteLLM Minor Fixes & Improvements (10/05/2024) (#6083)

2024-10-05 18:59:11 -04:00

test_get_model_info.py

fix: case-insensitive model cost map lookup

2025-12-18 17:25:43 -03:00

test_get_optional_params_embeddings.py

fix: fix test

2025-09-18 23:37:38 -07:00

test_get_optional_params_functions_not_supported.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_google_ai_studio_gemini.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_guardrails_ai.py

LiteLLM Minor Fixes & Improvements (10/15/2024) (#6242)

2024-10-16 07:32:06 -07:00

test_helicone_integration.py

fix tests

2025-10-25 10:19:24 -07:00

test_http_parsing_utils.py

test_http_parsing_utils.py

2025-07-10 18:20:41 -07:00

test_img_resize.py

fix: Support WebP image format and avoid token calculation error (#7182)

2024-12-12 14:32:39 -08:00

test_lakera_ai_prompt_injection.py

Merge pull request #9222 from BerriAI/litellm_snowflake_pr_mar_13

2025-03-13 21:35:39 -07:00

test_langchain_ChatLiteLLM.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_langsmith.py

fix: use fastuuid helper (#14903)

2025-09-25 15:47:01 -07:00

test_least_busy_routing.py

test: fixes because azure deactivated our account

2025-10-25 15:10:45 -07:00

test_litellm_max_budget.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_literalai.py

Litellm Minor Fixes & Improvements (10/03/2024) (#6049)

2024-10-03 18:02:28 -04:00

test_llm_guard.py

[Refactor] Move LLM Guard, Secret Detection to Enterprise Pip packagea (#10782)

2025-05-13 09:42:22 -07:00

test_load_test_router_s3.py

fix tests

2025-10-25 10:19:24 -07:00

test_loadtest_router.py

fix tests

2025-10-25 10:19:24 -07:00

test_logfire.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_logging.py

LiteLLM Minor Fixes & Improvements (11/05/2024) (#6590)

2024-11-07 04:17:05 +05:30

test_longer_context_fallback.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_lowest_cost_routing.py

fix tests

2025-10-25 10:19:24 -07:00

test_lowest_latency_routing.py

fix tests

2025-10-25 10:19:24 -07:00

test_lunary.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_max_tpm_rpm_limiter.py

(refactor) caching use LLMCachingHandler for async_get_cache and set_cache (#6208)

2024-10-14 16:34:01 +05:30

test_mem_leak.py

LiteLLM Minor Fixes & Improvements (10/30/2024) (#6519)

2024-11-02 00:44:32 +05:30

test_mem_usage.py

fix tests

2025-10-25 10:19:24 -07:00

test_mock_request.py

test_router_mock_request_with_mock_timeout_with_fallbacks

2025-09-27 13:57:43 -07:00

test_model_alias_map.py

test_model_alias_map

2025-09-01 17:59:40 -07:00

test_model_max_token_adjust.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_multiple_deployments.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_ollama_local_chat.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_ollama_local.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_ollama.py

[Fix] CI/CD - litellm_mapped_tests_llms | litellm_mapped_tests_core | caching_unit_tests (#18197)

2025-12-18 08:49:23 -08:00

test_openai_moderations_hook.py

Fix: gaurdrail moderation support with responses API

2026-01-12 17:27:13 +05:30

test_opik.py

OpikLogger: fix the bug with not incorrect attachment to existing trace & refactor (#15529)

2025-11-05 16:29:50 -08:00

test_pass_through_endpoints.py

Revert "[Fix] Security - Remove example API keys with high entropy (#18255)"

2025-12-20 20:48:11 +05:30

test_profiling_router.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_prometheus_service.py

test_router_with_caching

2025-09-27 11:38:08 -07:00

test_prompt_caching.py

claude-sonnet-4-5-20250929 fix

2025-10-31 18:20:52 -07:00

test_prompt_injection_detection.py

fix tests

2025-10-25 10:19:24 -07:00

test_promptlayer_integration.py

LiteLLM Minor Fixes & Improvements (11/05/2024) (#6590)

2024-11-07 04:17:05 +05:30

test_provider_specific_config.py

fix tests

2025-10-25 10:19:24 -07:00

test_pydantic_namespaces.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_pydantic.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_redis_batch_optimizations.py

[Perf] Alexsander fixes round 2 - Oct 18th (#15695)

2025-10-18 11:12:00 -07:00

test_register_model.py

Revert "test_update_model_cost_map_url"

2025-12-22 12:41:30 +05:30

test_router_auto_router.py

test fix claude-sonnet-4-5-20250929

2025-10-28 19:05:13 -07:00

test_router_batch_completion.py

test fix

2025-09-01 17:04:47 -07:00

test_router_budget_limiter.py

claude-sonnet-4-5-20250929 fix

2025-10-31 18:20:52 -07:00

test_router_caching.py

fix tests

2025-10-25 10:19:24 -07:00

test_router_client_init.py

test fix

2025-10-25 16:46:29 -07:00

test_router_cooldown_handlers.py

fix tests

2025-10-25 10:19:24 -07:00

test_router_custom_routing.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_router_debug_logs.py

fix tests

2025-10-25 10:19:24 -07:00

test_router_fallback_handlers.py

(Feat) - return x-litellm-attempted-fallbacks in responses from litellm proxy (#8558)

2025-02-15 14:54:23 -08:00

test_router_fallbacks.py

test_router_fallbacks_with_custom_model_costs

2026-01-17 16:34:46 -08:00

test_router_get_deployments.py

Fix:add async_get_available_deployment_for_pass_through in code tests

2026-01-16 16:37:44 +05:30

test_router_init.py

fix tests

2025-10-25 10:19:24 -07:00

test_router_max_parallel_requests.py

fix(lowest_tpm_rpm_routing.py): fix parallel rate limit check (#6577)

2024-11-05 22:03:44 +05:30

test_router_pattern_matching.py

Fix: Model matching priority in configuration

2026-01-13 11:44:48 +05:30

test_router_retries.py

fix(router): prevent retrying 4xx client errors (#19275)

2026-01-19 05:18:35 -08:00

test_router_timeout.py

fix tests

2025-10-25 10:19:24 -07:00

test_router_utils.py

test_router_get_deployment_credentials_with_provider

2025-11-22 10:46:12 -08:00

test_router_with_fallbacks.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_router.py

test fix claude-sonnet-4-5-20250929

2025-10-28 19:05:13 -07:00

test_rules.py

Litellm ruff linting enforcement (#5992)

2024-10-01 19:44:20 -04:00

test_sagemaker.py

test: mock sagemaker tests

2025-03-21 16:21:18 -07:00

test_scheduler.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_secret_detect_hook.py

[Refactor] Move LLM Guard, Secret Detection to Enterprise Pip packagea (#10782)

2025-05-13 09:42:22 -07:00

test_simple_shuffle.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_spend_calculate_endpoint.py

test fix

2025-09-01 17:04:47 -07:00

test_stream_chunk_builder.py

test_stream_chunk_builder_litellm_usage_chunks

2025-08-07 15:22:52 -07:00

test_streaming.py

test_bedrock_httpx_streaming

2026-01-07 15:02:10 +05:30

test_supabase_integration.py

Litellm ruff linting enforcement (#5992)

2024-10-01 19:44:20 -04:00

test_team_config.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_text_completion.py

[LLM Translation] Fix Realtime API endpoint for no intent (#13476)

2025-08-14 16:24:14 -07:00

test_timeout.py

fix tests

2025-10-25 10:19:24 -07:00

test_together_ai.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_tpm_rpm_routing_v2.py

fix tests

2025-10-25 10:19:24 -07:00

test_traceloop.py

test: skip redundant test

2025-02-10 22:13:58 -08:00

test_ui_sso_helper_utils.py

LiteLLM Minor Fixes & Improvements (10/17/2024) (#6293)

2024-10-17 22:09:11 -07:00

test_unit_test_caching.py

fix: use fastuuid helper (#14903)

2025-09-25 15:47:01 -07:00

test_update_spend.py

test_batch_update_spend

2025-04-01 07:12:29 -07:00

test_validate_environment.py

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

test_wandb.py

LiteLLM Minor Fixes & Improvements (11/05/2024) (#6590)

2024-11-07 04:17:05 +05:30

user_cost.json

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

vertex_ai.jsonl

refactor: move all testing to top-level of repo

2024-09-28 21:08:14 -07:00

vertex_batch_completions.jsonl

(feat) add Vertex Batches API support in OpenAI format (#7032)

2024-12-04 19:40:28 -08:00

vertex_key.json

ci/cd update vertex acct

2025-01-05 13:43:32 -08:00

whitelisted_bedrock_models.txt

Add supports_pdf_input: true to Claude 3.7 bedrock models (#9917)

2025-05-01 14:56:54 -07:00