google-genai-sdk-python

---
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."
license: "MIT"
---

# 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](references/setup.md)**: Installation, auth, client initialization.
- **[Models](references/models.md)**: Recommended models (Flash, Pro, Lite, Imagen, Veo).
- **[Text Generation](references/text_generation.md)**: Basic inference, streaming, system instructions, safety.
- **[Chat](references/chat.md)**: Multi-turn conversations and history.
- **[Reasoning](references/reasoning.md)**: Thinking config (`thinking_level` / `thinking_budget`), thought signatures.
- **[Structured Output](references/structured_output.md)**: JSON schemas, Pydantic models, Enums.
- **[Multimodal Inputs](references/multimodal_inputs.md)**: Images, audio, video, PDFs, media resolution.
- **[Tools](references/tools.md)**: Function calling, code execution, Google Search grounding.
- **[Media Generation](references/media_generation.md)**: Image generation/editing (Imagen), video generation (Veo).
- **[Source Code](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`.