Skip to content

docs: add CJK language limitation warning for Gemini 2.5 models (#2134) #2142

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
shanujans wants to merge 4 commits into
base: main
Choose a base branch
from
+20 −1
Open

docs: add CJK language limitation warning for Gemini 2.5 models (#2134) #2142

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7cbfdf8
Import keras module in Google Gen AI SDK
shanujans Nov 6, 2025
7a658b6
Update release-trigger.yml
shanujans Dec 5, 2025
3e80e4d
Merge branch 'googleapis:main' into main
shanujans Dec 5, 2025
d5645cf
Update codegen_instructions.md
shanujans Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/release-trigger.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1 @@
enabled: true
enabled: false
18 changes: 18 additions & 0 deletions codegen_instructions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,6 +118,16 @@ The `google-genai` library requires creating a client object for all API calls.
user:
- **Gemini 2.0 Series**: `gemini-2.0-flash`, `gemini-2.0-flash-lite`

> **⚠️ Known limitation — Gemini 2.5 series (CJK languages):** All Gemini 2.5
> models (`gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-2.5-flash-lite`)
> currently fail to correctly process CJK (Japanese, Chinese, Korean) text
> input via the REST API. The model may interpret valid UTF-8 CJK characters as
> garbled/corrupted text. Google Search Grounding is also affected —
> `webSearchQueries` returns empty `[]` for CJK input on these models.
> **If your application requires CJK language input, use `gemini-3-pro-preview`
> or another Gemini 3.x model as a workaround until this is resolved.**
> See [issue #2134](https://github.com/googleapis/python-genai/issues/2134).

- Do not use the following deprecated models (or their variants like
`gemini-1.5-flash-latest`):
- **Prohibited:** `gemini-1.5-flash`
Expand Down Expand Up @@ -571,6 +581,14 @@ print(f"Search Pages: {', '.join([site.web.title for site in response.candidates
The output `response.text` will likely not be in JSON format, do not attempt to
parse it as JSON.

> **⚠️ Known limitation — CJK languages with Gemini 2.5:** Search Grounding
> does not work correctly with CJK (Japanese, Chinese, Korean) input on any
> Gemini 2.5 model. `webSearchQueries` returns an empty list `[]` and the model
> treats the input as garbled text. English input on the same models works
> correctly. **Use a Gemini 3.x model (e.g. `gemini-3-pro-preview`) for Search
> Grounding with CJK queries.**
> See [issue #2134](https://github.com/googleapis/python-genai/issues/2134).

### Content and Part Hierarchy

While the simpler API call is often sufficient, you may run into scenarios where
Expand Down
1 change: 1 addition & 0 deletions google/genai/__init__.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@
"""Google Gen AI SDK"""

from . import types
from . import keras
from . import version
from .client import Client

Expand Down