Text generation(genai): Add new code samples (#13127)

* Text generation(genai): Add new code samples

* Text generation(genai): use latest SDK

Update to Youtube example region tag

* docs(genai): Update textgen_with_youtube_video.py sample region tags

Author: msampathkumar

genai/text_generation/requirements.txt

@@ -1 +1 @@
-google-genai==0.7.0
+google-genai==0.8.0

genai/text_generation/test_data/describe_video_content.mp4

@@ -14,19 +14,23 @@
 
 import os
 
+import textgen_async_with_txt
+import textgen_chat_stream_with_txt
 import textgen_chat_with_txt
-import textgen_chat_with_txt_stream
+import textgen_code_with_pdf
 import textgen_config_with_txt
 import textgen_sys_instr_with_txt
 import textgen_transcript_with_gcs_audio
 import textgen_with_gcs_audio
+import textgen_with_local_video
 import textgen_with_multi_img
 import textgen_with_multi_local_img
 import textgen_with_mute_video
 import textgen_with_txt
 import textgen_with_txt_img
 import textgen_with_txt_stream
 import textgen_with_video
+import textgen_with_youtube_video
 
 
 os.environ["GOOGLE_GENAI_USE_VERTEXAI"] = "True"
@@ -51,7 +55,7 @@ def test_textgen_chat_with_txt() -> None:
 
 
 def test_textgen_chat_with_txt_stream() -> None:
-    response = textgen_chat_with_txt_stream.generate_content()
+    response = textgen_chat_stream_with_txt.generate_content()
     assert response
 
 
@@ -101,3 +105,23 @@ def test_textgen_transcript_with_gcs_audio() -> None:
 def test_textgen_with_video() -> None:
     response = textgen_with_video.generate_content()
     assert response
+
+
+def test_textgen_async_with_txt() -> None:
+    response = textgen_async_with_txt.generate_content()
+    assert response
+
+
+def test_textgen_with_local_video() -> None:
+    response = textgen_with_local_video.generate_content()
+    assert response
+
+
+def test_textgen_with_youtube_video() -> None:
+    response = textgen_with_youtube_video.generate_content()
+    assert response
+
+
+def test_textgen_code_with_pdf() -> None:
+    response = textgen_code_with_pdf.generate_content()
+    assert response

genai/text_generation/test_text_generation.py

@@ -0,0 +1,45 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import asyncio
+
+
+async def generate_content() -> str:
+    # [START googlegenaisdk_textgen_async_with_txt]
+    from google import genai
+    from google.genai.types import GenerateContentConfig
+
+    client = genai.Client()
+    model_id = "gemini-2.0-flash-exp"
+
+    response = await client.aio.models.generate_content(
+        model=model_id,
+        contents="Compose a song about the adventures of a time-traveling squirrel.",
+        config=GenerateContentConfig(
+            response_modalities=["TEXT"],
+        ),
+    )
+
+    print(response.text)
+    # Example response:
+    # (Verse 1)
+    # Sammy the squirrel, a furry little friend
+    # Had a knack for adventure, beyond all comprehend
+
+    # [END googlegenaisdk_textgen_async_with_txt]
+    return response.text
+
+
+if __name__ == "__main__":
+    asyncio.run(generate_content())

genai/text_generation/textgen_async_with_txt.py

@@ -14,7 +14,7 @@
 
 
 def generate_content() -> str:
-    # [START googlegenaisdk_textgen_chat_with_txt_stream]
+    # [START googlegenaisdk_textgen_chat_stream_with_txt]
     from google import genai
 
     client = genai.Client()
@@ -29,7 +29,7 @@ def generate_content() -> str:
     #  sky appears blue due to a phenomenon called **Rayleigh scattering**. Here's
     #  a breakdown of why:
     # ...
-    # [END googlegenaisdk_textgen_chat_with_txt_stream]
+    # [END googlegenaisdk_textgen_chat_stream_with_txt]
     return response_text
 
 

genai/text_generation/textgen_chat_with_txt_stream.py renamed to genai/text_generation/textgen_chat_stream_with_txt.py

@@ -22,15 +22,12 @@ def generate_content() -> str:
     chat = client.chats.create(
         model="gemini-2.0-flash-001",
         history=[
-            Content(
-                parts=[Part(text="Hello")],
-                role="user"
-            ),
+            Content(parts=[Part(text="Hello")], role="user"),
             Content(
                 parts=[Part(text="Great to meet you. What would you like to know?")],
-                role="model"
-            )
-        ]
+                role="model",
+            ),
+        ],
     )
     response = chat.send_message("tell me a story")
     print(response.text)

genai/text_generation/textgen_chat_with_txt.py

@@ -0,0 +1,49 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# !This sample works with Google Cloud Vertex AI API only.
+
+
+def generate_content() -> str:
+    # [START googlegenaisdk_textgen_code_with_pdf]
+    from google import genai
+    from google.genai import types
+
+    client = genai.Client()
+    model_id = "gemini-2.0-flash-exp"
+
+    python_code = types.Part.from_uri(
+        file_uri="https://storage.googleapis.com/cloud-samples-data/generative-ai/text/inefficient_fibonacci_series_python_code.pdf",
+        mime_type="application/pdf",
+    )
+
+    response = client.models.generate_content(
+        model=model_id,
+        contents=[
+            python_code,
+            "Convert this python code to use Google Python Style Guide.",
+        ],
+    )
+
+    print(response.text)
+    # Example response:
+    # ```python
+    # def fibonacci(n: int) -> list[int] | str:
+    # ...
+    # [END googlegenaisdk_textgen_code_with_pdf]
+    return response.text
+
+
+if __name__ == "__main__":
+    generate_content()

genai/text_generation/textgen_code_with_pdf.py

@@ -26,8 +26,15 @@ def generate_content() -> str:
         config=types.GenerateContentConfig(
             temperature=0,
             candidate_count=1,
-            response_mime_type="application/json"
-        )
+            response_mime_type="application/json",
+            top_p=0.95,
+            top_k=20,
+            seed=5,
+            max_output_tokens=100,
+            stop_sequences=["STOP!"],
+            presence_penalty=0.0,
+            frequency_penalty=0.0,
+        ),
     )
     print(response.text)
     # Example response:

genai/text_generation/textgen_config_with_txt.py

@@ -25,9 +25,9 @@ def generate_content() -> str:
         config=types.GenerateContentConfig(
             system_instruction=[
                 "You're a language translator.",
-                "Your mission is to translate text in English to French."
+                "Your mission is to translate text in English to French.",
             ]
-        )
+        ),
     )
     print(response.text)
     # Example response:

genai/text_generation/textgen_sys_instr_with_txt.py

@@ -30,9 +30,9 @@ def generate_content() -> str:
             prompt,
             Part.from_uri(
                 file_uri="gs://cloud-samples-data/generative-ai/audio/pixel.mp3",
-                mime_type="audio/mpeg"
-            )
-        ]
+                mime_type="audio/mpeg",
+            ),
+        ],
     )
     print(response.text)
     # Example response: