---
name: google-genai-sdk-python
description: Expert guidance for writing Python code using the official Google GenAI SDK (google-genai) for Gemini API and Vertex AI. Use for text generation, multimodal inputs, reasoning, tools, and media generation.
title: google-genai-sdk-python
canonical_url: https://skilld.dev/gh/cnemri/google-genai-skills/google-genai-sdk-python
last_updated: 2026-09-29T08:24:23.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/chat.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/chat.md), [references/media_generation.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/media_generation.md), [references/models.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/models.md), [references/multimodal_inputs.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/multimodal_inputs.md), [references/reasoning.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/reasoning.md), [references/setup.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/setup.md), [references/source_code.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/source_code.md), [references/structured_output.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/structured_output.md), [references/text_generation.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/text_generation.md), [references/tools.md](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/tools.md).
>
> If the user asked to install this Skill, run `npx skilld install cnemri/google-genai-skills/google-genai-sdk-python`. Install writes the Skill files into the project, so every session loads them.

# Google GenAI Python SDK Skill

Use this skill to write high-quality, idiomatic Python code for the Gemini API.

## Reference Materials

Identify the user's task and refer to the relevant file:

- **[Setup & Client](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/setup.md)**: Installation, auth, client initialization.
- **[Models](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/models.md)**: Recommended models (Flash, Pro, Lite, Imagen, Veo).
- **[Text Generation](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/text_generation.md)**: Basic inference, streaming, system instructions, safety.
- **[Chat](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/chat.md)**: Multi-turn conversations and history.
- **[Reasoning](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/reasoning.md)**: Thinking config (`thinking_level` / `thinking_budget`), thought signatures.
- **[Structured Output](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/structured_output.md)**: JSON schemas, Pydantic models, Enums.
- **[Multimodal Inputs](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/multimodal_inputs.md)**: Images, audio, video, PDFs, media resolution.
- **[Tools](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/tools.md)**: Function calling, code execution, Google Search grounding.
- **[Media Generation](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/media_generation.md)**: Image generation/editing (Imagen), video generation (Veo).
- **[Source Code](https://skilld.dev/api/skills-raw/cnemri/google-genai-skills/google-genai-sdk-python/references/source_code.md)**: Raw SDK source code for deep inspection.

## Core Principles

1.  **Unified SDK**: Always use `google-genai`.
2.  **Stateless Models**: Use `client.models` for single requests.
3.  **Stateful Chats**: Use `client.chats` for conversations.
4.  **Types**: Import from `google.genai.types`.