Gemini API reference | Google AI for Developers

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="157101835696-ooapojlodmuabs2do2vuhhnf90bccmoi.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google AI for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#1967d2"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/googledevai/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/css/app.css"> <link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/css/dark-theme.css" disabled> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/touchicon-180-new.png"><link rel="canonical" href="https://ai.google.dev/api"><link rel="search" type="application/opensearchdescription+xml" title="Google AI for Developers" href="https://ai.google.dev/s/opensearch.xml"> <title>Gemini API reference  |  Google AI for Developers</title> <meta property="og:title" content="Gemini API reference  |  Google AI for Developers"><meta property="og:url" content="https://ai.google.dev/api"><meta property="og:image" content="https://ai.google.dev/static/site-assets/images/share-gemini-api.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "Gemini API", "item": "https://ai.google.dev/gemini-api" },{ "@type": "ListItem", "position": 2, "name": "Gemini API reference", "item": "https://ai.google.dev/api" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="" template="page" theme="googledevai-theme" type="reference" appearance layout="docs" display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <a href="#main-content" class="skip-link button"> Skip to main content </a> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner" keep-tabs-visible> <div class="devsite-header--inner" data-nosnippet> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="/" class="devsite-site-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Site logo" track-type="globalNav" track-name="googleAIForDevelopers" track-metadata-position="nav" track-metadata-eventDetail="nav"> <picture> <source srcset="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/lockup-dark-theme-new.svg" media="(prefers-color-scheme: dark)" class="devsite-dark-theme"> <img src="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/lockup-new.svg" class="devsite-site-logo" alt="Google AI for Developers"> </picture> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> <devsite-tabs class="upper-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Upper tabs"> <tab class="devsite-dropdown devsite-active "> <a href="https://ai.google.dev/gemini-api/docs" class="devsite-tabs-content gc-analytics-event " track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs" track-type="nav" track-metadata-position="nav - models" track-metadata-module="primary nav" aria-label="Models, selected" data-category="Site-Wide Custom Events" data-label="Tab: Models" track-name="models" > Models </a> <button aria-haspopup="menu" aria-expanded="false" aria-label="Dropdown menu for Models" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs" track-metadata-position="nav - models" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Models" track-name="models" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></button> <div class="devsite-tabs-dropdown" role="menu" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Gemini</li> <li class="devsite-nav-item"> <a href="https://deepmind.google/gemini" track-type="nav" track-metadata-eventdetail="https://deepmind.google/gemini" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemini" tooltip > <div class="devsite-nav-item-title"> About </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemini-api/docs" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemini" tooltip > <div class="devsite-nav-item-title"> Docs </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/api" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/api" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemini" tooltip > <div class="devsite-nav-item-title"> API reference </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/pricing" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/pricing" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemini" tooltip > <div class="devsite-nav-item-title"> Pricing </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Imagen</li> <li class="devsite-nav-item"> <a href="https://deepmind.google/technologies/imagen-3/" track-type="nav" track-metadata-eventdetail="https://deepmind.google/technologies/imagen-3/" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="imagen" tooltip > <div class="devsite-nav-item-title"> About </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemini-api/docs" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="imagen" tooltip > <div class="devsite-nav-item-title"> Docs </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/pricing" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/pricing" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="imagen" tooltip > <div class="devsite-nav-item-title"> Pricing </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Gemma</li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemma" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemma" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemma" tooltip > <div class="devsite-nav-item-title"> About </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemma/docs" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemma/docs" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemma" tooltip > <div class="devsite-nav-item-title"> Docs </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemma/gemmaverse" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemma/gemmaverse" track-metadata-position="nav - models" track-metadata-module="tertiary nav" track-metadata-module_headline="gemma" tooltip > <div class="devsite-nav-item-title"> Gemmaverse </div> </a> </li> </ul> </div> </div> </div> </tab> <tab class="devsite-dropdown devsite-dropdown-full "> <button class="devsite-tabs-content devsite-tabs-dropdown-only gc-analytics-event devsite-icon devsite-icon-arrow-drop-down" track-type="nav" track-metadata-position="nav - solutions" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Solutions" track-name="solutions" > Solutions </button> <div class="devsite-tabs-dropdown" role="menu" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Build with Gemini</li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemini-api/docs" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="build with gemini" tooltip > <div class="devsite-nav-item-title"> Gemini API </div> </a> </li> <li class="devsite-nav-item"> <a href="https://aistudio.google.com" track-type="nav" track-metadata-eventdetail="https://aistudio.google.com" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="build with gemini" tooltip > <div class="devsite-nav-item-title"> Google AI Studio </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Customize Gemma open models</li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemma" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemma" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="customize gemma open models" tooltip > <div class="devsite-nav-item-title"> Gemma open models </div> </a> </li> <li class="devsite-nav-item"> <a href="https://keras.io/keras_3/" track-type="nav" track-metadata-eventdetail="https://keras.io/keras_3/" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="customize gemma open models" tooltip > <div class="devsite-nav-item-title"> Multi-framework with Keras </div> </a> </li> <li class="devsite-nav-item"> <a href="https://colab.sandbox.google.com/github/google/generative-ai-docs/blob/main/site/en/gemma/docs/lora_tuning.ipynb" track-type="nav" track-metadata-eventdetail="https://colab.sandbox.google.com/github/google/generative-ai-docs/blob/main/site/en/gemma/docs/lora_tuning.ipynb" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="customize gemma open models" tooltip > <div class="devsite-nav-item-title"> Fine-tune in Colab </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Run on-device</li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/edge" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/edge" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="run on-device" tooltip > <div class="devsite-nav-item-title"> Google AI Edge </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.android.com/ai/gemini-nano" track-type="nav" track-metadata-eventdetail="https://developer.android.com/ai/gemini-nano" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="run on-device" tooltip > <div class="devsite-nav-item-title"> Gemini Nano on Android </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/ai/built-in" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/ai/built-in" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="run on-device" tooltip > <div class="devsite-nav-item-title"> Chrome built-in web APIs </div> </a> </li> </ul> </div> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-title" role="heading" tooltip>Build responsibly</li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/responsible" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/responsible" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="build responsibly" tooltip > <div class="devsite-nav-item-title"> Responsible GenAI Toolkit </div> </a> </li> <li class="devsite-nav-item"> <a href="https://saif.google" track-type="nav" track-metadata-eventdetail="https://saif.google" track-metadata-position="nav - solutions" track-metadata-module="tertiary nav" track-metadata-module_headline="build responsibly" tooltip > <div class="devsite-nav-item-title"> Secure AI Framework </div> </a> </li> </ul> </div> </div> </div> </tab> <tab class="devsite-dropdown "> <button class="devsite-tabs-content devsite-tabs-dropdown-only gc-analytics-event devsite-icon devsite-icon-arrow-drop-down" track-type="nav" track-metadata-position="nav - code assistance" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Code assistance" track-name="code assistance" > Code assistance </button> <div class="devsite-tabs-dropdown" role="menu" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://developer.android.com/gemini-in-android" track-type="nav" track-metadata-eventdetail="https://developer.android.com/gemini-in-android" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Android Studio </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/devtools/console/understand-messages" track-type="nav" track-metadata-eventdetail="https://developer.chrome.com/docs/devtools/console/understand-messages" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Chrome DevTools </div> </a> </li> <li class="devsite-nav-item"> <a href="https://colab.google" track-type="nav" track-metadata-eventdetail="https://colab.google" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Colab </div> </a> </li> <li class="devsite-nav-item"> <a href="https://firebase.google.com/products/generative-ai" track-type="nav" track-metadata-eventdetail="https://firebase.google.com/products/generative-ai" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Firebase </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/products/gemini/code-assist" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/products/gemini/code-assist" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud </div> </a> </li> <li class="devsite-nav-item"> <a href="https://plugins.jetbrains.com/plugin/8079-google-cloud-code" track-type="nav" track-metadata-eventdetail="https://plugins.jetbrains.com/plugin/8079-google-cloud-code" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> JetBrains </div> </a> </li> <li class="devsite-nav-item"> <a href="https://labs.google.com/jules/home" track-type="nav" track-metadata-eventdetail="https://labs.google.com/jules/home" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Jules </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developers.google.com/idx/guides/code-with-gemini-in-idx" track-type="nav" track-metadata-eventdetail="https://developers.google.com/idx/guides/code-with-gemini-in-idx" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Project IDX </div> </a> </li> <li class="devsite-nav-item"> <a href="https://marketplace.visualstudio.com/items?itemName=GoogleCloudTools.cloudcode" track-type="nav" track-metadata-eventdetail="https://marketplace.visualstudio.com/items?itemName=GoogleCloudTools.cloudcode" track-metadata-position="nav - code assistance" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> VS Code </div> </a> </li> </ul> </div> </div> </div> </tab> <tab class="devsite-dropdown "> <button class="devsite-tabs-content devsite-tabs-dropdown-only gc-analytics-event devsite-icon devsite-icon-arrow-drop-down" track-type="nav" track-metadata-position="nav - showcase" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Showcase" track-name="showcase" > Showcase </button> <div class="devsite-tabs-dropdown" role="menu" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://ai.google.dev/showcase" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/showcase" track-metadata-position="nav - showcase" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Gemini Showcase </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/competition" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/competition" track-metadata-position="nav - showcase" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Gemini API Developer Competition </div> </a> </li> </ul> </div> </div> </div> </tab> <tab class="devsite-dropdown "> <button class="devsite-tabs-content devsite-tabs-dropdown-only gc-analytics-event devsite-icon devsite-icon-arrow-drop-down" track-type="nav" track-metadata-position="nav - community" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Community" track-name="community" > Community </button> <div class="devsite-tabs-dropdown" role="menu" aria-label="submenu" hidden> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://discuss.ai.google.dev" track-type="nav" track-metadata-eventdetail="https://discuss.ai.google.dev" track-metadata-position="nav - community" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google AI Forum </div> </a> </li> <li class="devsite-nav-item"> <a href="https://ai.google.dev/gemini-api/docs/gemini-for-research" track-type="nav" track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs/gemini-for-research" track-metadata-position="nav - community" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Gemini for Research </div> </a> </li> </ul> </div> </div> </div> </tab> </nav> </devsite-tabs> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="Gemini API" tenant-name="Google AI for Developers" project-scope="/gemini-api" url-scoped="https://ai.google.dev/s/results/gemini-api" > <form class="devsite-search-form" action="https://ai.google.dev/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-appearance-selector></devsite-appearance-selector> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="sq" >Shqip</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab > <a href="https://ai.google.dev/gemini-api/docs" class="devsite-tabs-content gc-analytics-event " track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs" track-type="nav" track-metadata-position="nav - gemini api docs" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Gemini API docs" track-name="gemini api docs" > Gemini API docs </a> </tab> <tab class="devsite-active"> <a href="https://ai.google.dev/api" class="devsite-tabs-content gc-analytics-event " track-metadata-eventdetail="https://ai.google.dev/api" track-type="nav" track-metadata-position="nav - api reference" track-metadata-module="primary nav" aria-label="API Reference, selected" data-category="Site-Wide Custom Events" data-label="Tab: API Reference" track-name="api reference" > API Reference </a> </tab> <tab > <a href="https://ai.google.dev/gemini-api/docs/sdks" class="devsite-tabs-content gc-analytics-event " track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs/sdks" track-type="nav" track-metadata-position="nav - sdks" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: SDKs" track-name="sdks" > SDKs </a> </tab> <tab > <a href="https://ai.google.dev/gemini-api/docs/pricing" class="devsite-tabs-content gc-analytics-event " track-metadata-eventdetail="https://ai.google.dev/gemini-api/docs/pricing" track-type="nav" track-metadata-position="nav - pricing" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Pricing" track-name="pricing" > Pricing </a> </tab> <tab > <a href="https://github.com/google-gemini/cookbook" class="devsite-tabs-content gc-analytics-event " track-metadata-eventdetail="https://github.com/google-gemini/cookbook" track-type="nav" track-metadata-position="nav - cookbook" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Cookbook" track-name="cookbook" > Cookbook </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" hidden> <span class="filter-list-icon material-icons" aria-hidden="true"></span> <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> <span class="filter-clear-button hidden" data-title="Clear filter" aria-label="Clear filter" role="button" tabindex="0"></span> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="/" class="devsite-site-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Site logo" track-type="globalNav" track-name="googleAIForDevelopers" track-metadata-position="nav" track-metadata-eventDetail="nav"> <picture> <source srcset="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/lockup-dark-theme-new.svg" media="(prefers-color-scheme: dark)" class="devsite-dark-theme"> <img src="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/lockup-new.svg" class="devsite-site-logo" alt="Google AI for Developers"> </picture> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/gemini-api/docs" class="devsite-nav-title gc-analytics-event devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Models" track-name="models" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Models" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Models </span> </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Models" track-name="models" > <span class="devsite-nav-text" tooltip menu="Models"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Models"> </span> </span> </li> </ul> <ul class="devsite-nav-responsive-tabs"> <li class="devsite-nav-item"> <a href="/gemini-api/docs" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Gemini API docs" track-name="gemini api docs" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemini API docs" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemini API docs </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/api" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: API Reference" track-name="api reference" data-category="Site-Wide Custom Events" data-label="Responsive Tab: API Reference" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip menu="_book"> API Reference </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="_book"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemini-api/docs/sdks" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: SDKs" track-name="sdks" data-category="Site-Wide Custom Events" data-label="Responsive Tab: SDKs" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > SDKs </span> <span class="devsite-nav-icon material-icons" data-icon="forward" > </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemini-api/docs/pricing" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Pricing" track-name="pricing" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Pricing" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Pricing </span> </a> </li> <li class="devsite-nav-item"> <a href="https://github.com/google-gemini/cookbook" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Cookbook" track-name="cookbook" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Cookbook" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Cookbook </span> </a> </li> </ul> </li> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Solutions" track-name="solutions" > <span class="devsite-nav-text" tooltip > Solutions </span> </span> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Solutions" track-name="solutions" > <span class="devsite-nav-text" tooltip menu="Solutions"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Solutions"> </span> </span> </li> </ul> </li> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Code assistance" track-name="code assistance" > <span class="devsite-nav-text" tooltip > Code assistance </span> </span> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Code assistance" track-name="code assistance" > <span class="devsite-nav-text" tooltip menu="Code assistance"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Code assistance"> </span> </span> </li> </ul> </li> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Showcase" track-name="showcase" > <span class="devsite-nav-text" tooltip > Showcase </span> </span> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Showcase" track-name="showcase" > <span class="devsite-nav-text" tooltip menu="Showcase"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Showcase"> </span> </span> </li> </ul> </li> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Community" track-name="community" > <span class="devsite-nav-text" tooltip > Community </span> </span> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> <span class="devsite-nav-title" tooltip data-category="Site-Wide Custom Events" data-label="Tab: Community" track-name="community" > <span class="devsite-nav-text" tooltip menu="Community"> More </span> <span class="devsite-nav-icon material-icons" data-icon="forward" menu="Community"> </span> </span> </li> </ul> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item"><a href="/api" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api" ><span class="devsite-nav-text" tooltip>Overview</span></a></li> <li class="devsite-nav-item"><a href="/gemini-api/docs/api-versions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /gemini-api/docs/api-versions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/gemini-api/docs/api-versions" ><span class="devsite-nav-text" tooltip>API versions</span></a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> <span class="devsite-nav-text" tooltip>Capabilities</span> </div></li> <li class="devsite-nav-item"><a href="/api/models" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/models" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/models" ><span class="devsite-nav-text" tooltip>Models</span></a></li> <li class="devsite-nav-item devsite-nav-experimental"><a href="/api/generate-content" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/generate-content" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/generate-content" ><span class="devsite-nav-text" tooltip>Generating content</span><span class="devsite-nav-icon material-icons" data-icon="experimental" data-title="Experimental!" aria-hidden="true"></span></a></li> <li class="devsite-nav-item"><a href="/api/tokens" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/tokens" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/tokens" ><span class="devsite-nav-text" tooltip>Tokens</span></a></li> <li class="devsite-nav-item"><a href="/api/files" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/files" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/files" ><span class="devsite-nav-text" tooltip>Files</span></a></li> <li class="devsite-nav-item"><a href="/api/caching" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/caching" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/caching" ><span class="devsite-nav-text" tooltip>Caching</span></a></li> <li class="devsite-nav-item"><a href="/api/embeddings" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/embeddings" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/embeddings" ><span class="devsite-nav-text" tooltip>Embeddings</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Tuning</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/api/tuning" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/tuning" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/tuning" ><span class="devsite-nav-text" tooltip>Tuning</span></a></li><li class="devsite-nav-item"><a href="/api/tuning/permissions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/tuning/permissions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/tuning/permissions" ><span class="devsite-nav-text" tooltip>Permissions</span></a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Semantic retrieval</span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/api/semantic-retrieval/question-answering" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/semantic-retrieval/question-answering" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/semantic-retrieval/question-answering" ><span class="devsite-nav-text" tooltip>Question answering</span></a></li><li class="devsite-nav-item"><a href="/api/semantic-retrieval/corpora" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/semantic-retrieval/corpora" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/semantic-retrieval/corpora" ><span class="devsite-nav-text" tooltip>Corpus</span></a></li><li class="devsite-nav-item"><a href="/api/semantic-retrieval/documents" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/semantic-retrieval/documents" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/semantic-retrieval/documents" ><span class="devsite-nav-text" tooltip>Document</span></a></li><li class="devsite-nav-item"><a href="/api/semantic-retrieval/chunks" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/semantic-retrieval/chunks" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/semantic-retrieval/chunks" ><span class="devsite-nav-text" tooltip>Chunk</span></a></li><li class="devsite-nav-item"><a href="/api/semantic-retrieval/permissions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/semantic-retrieval/permissions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/semantic-retrieval/permissions" ><span class="devsite-nav-text" tooltip>Permissions</span></a></li></ul></div></li> <li class="devsite-nav-item"><a href="/api/all-methods" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/all-methods" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/all-methods" ><span class="devsite-nav-text" tooltip>All methods</span></a></li> <li class="devsite-nav-item devsite-nav-expandable devsite-nav-deprecated"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> <span class="devsite-nav-text" tooltip>Deprecated</span><span class="devsite-nav-icon material-icons" data-icon="deprecated" data-title="Deprecated" aria-hidden="true"></span> </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/api/palm" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /api/palm" track-type="bookNav" track-name="click" track-metadata-eventdetail="/api/palm" ><span class="devsite-nav-text" tooltip>PaLM (decomissioned)</span></a></li></ul></div></li> </ul> <ul class="devsite-nav-list" menu="Models" aria-label="Side menu" hidden> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Gemini </span> </span> </li> <li class="devsite-nav-item"> <a href="https://deepmind.google/gemini" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: About" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > About </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemini-api/docs" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Docs" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Docs </span> </a> </li> <li class="devsite-nav-item"> <a href="/api" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: API reference" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > API reference </span> </a> </li> <li class="devsite-nav-item"> <a href="/pricing" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Pricing" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Pricing </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Imagen </span> </span> </li> <li class="devsite-nav-item"> <a href="https://deepmind.google/technologies/imagen-3/" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: About" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > About </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemini-api/docs" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Docs" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Docs </span> </a> </li> <li class="devsite-nav-item"> <a href="/pricing" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Pricing" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Pricing </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Gemma </span> </span> </li> <li class="devsite-nav-item"> <a href="/gemma" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: About" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > About </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemma/docs" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Docs" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Docs </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemma/gemmaverse" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemmaverse" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemmaverse </span> </a> </li> </ul> <ul class="devsite-nav-list" menu="Solutions" aria-label="Side menu" hidden> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Build with Gemini </span> </span> </li> <li class="devsite-nav-item"> <a href="/gemini-api/docs" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemini API" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemini API </span> </a> </li> <li class="devsite-nav-item"> <a href="https://aistudio.google.com" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google AI Studio" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Google AI Studio </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Customize Gemma open models </span> </span> </li> <li class="devsite-nav-item"> <a href="/gemma" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemma open models" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemma open models </span> </a> </li> <li class="devsite-nav-item"> <a href="https://keras.io/keras_3/" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Multi-framework with Keras" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Multi-framework with Keras </span> </a> </li> <li class="devsite-nav-item"> <a href="https://colab.sandbox.google.com/github/google/generative-ai-docs/blob/main/site/en/gemma/docs/lora_tuning.ipynb" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Fine-tune in Colab" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Fine-tune in Colab </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Run on-device </span> </span> </li> <li class="devsite-nav-item"> <a href="/edge" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google AI Edge" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Google AI Edge </span> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.android.com/ai/gemini-nano" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemini Nano on Android" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemini Nano on Android </span> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/ai/built-in" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Chrome built-in web APIs" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Chrome built-in web APIs </span> </a> </li> <li class="devsite-nav-item devsite-nav-heading"> <span class="devsite-nav-title" tooltip > <span class="devsite-nav-text" tooltip > Build responsibly </span> </span> </li> <li class="devsite-nav-item"> <a href="/responsible" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Responsible GenAI Toolkit" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Responsible GenAI Toolkit </span> </a> </li> <li class="devsite-nav-item"> <a href="https://saif.google" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Secure AI Framework" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Secure AI Framework </span> </a> </li> </ul> <ul class="devsite-nav-list" menu="Code assistance" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="https://developer.android.com/gemini-in-android" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Android Studio" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Android Studio </span> </a> </li> <li class="devsite-nav-item"> <a href="https://developer.chrome.com/docs/devtools/console/understand-messages" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Chrome DevTools" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Chrome DevTools </span> </a> </li> <li class="devsite-nav-item"> <a href="https://colab.google" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Colab" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Colab </span> </a> </li> <li class="devsite-nav-item"> <a href="https://firebase.google.com/products/generative-ai" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Firebase" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Firebase </span> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/products/gemini/code-assist" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Google Cloud </span> </a> </li> <li class="devsite-nav-item"> <a href="https://plugins.jetbrains.com/plugin/8079-google-cloud-code" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: JetBrains" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > JetBrains </span> </a> </li> <li class="devsite-nav-item"> <a href="https://labs.google.com/jules/home" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Jules" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Jules </span> </a> </li> <li class="devsite-nav-item"> <a href="https://developers.google.com/idx/guides/code-with-gemini-in-idx" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Project IDX" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Project IDX </span> </a> </li> <li class="devsite-nav-item"> <a href="https://marketplace.visualstudio.com/items?itemName=GoogleCloudTools.cloudcode" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: VS Code" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > VS Code </span> </a> </li> </ul> <ul class="devsite-nav-list" menu="Showcase" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="/showcase" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemini Showcase" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemini Showcase </span> </a> </li> <li class="devsite-nav-item"> <a href="/competition" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemini API Developer Competition" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemini API Developer Competition </span> </a> </li> </ul> <ul class="devsite-nav-list" menu="Community" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="https://discuss.ai.google.dev" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google AI Forum" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Google AI Forum </span> </a> </li> <li class="devsite-nav-item"> <a href="/gemini-api/docs/gemini-for-research" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Gemini for Research" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> <span class="devsite-nav-text" tooltip > Gemini for Research </span> </a> </li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" id="main-content" class="devsite-main-content" has-book-nav has-sidebar > <div class="devsite-sidebar"> <div class="devsite-sidebar-content"> <devsite-toc class="devsite-nav" role="navigation" aria-label="On this page" depth="2" scrollbars ></devsite-toc> <devsite-recommendations-sidebar class="nocontent devsite-nav"> </devsite-recommendations-sidebar> </div> </div> <devsite-content> <article class="devsite-article"><style> /* Styles inlined from /site-assets/css/style.css */ body[theme="googledevai-theme"] { --devsite-background-0: var(--devsite-background-1); --devsite-button-border: 1px solid #747775; --devsite-button-border-radius: 20rem; --devsite-button-font: 500 14px/36px 'Google Sans Text', Roboto, sans-serif; --devsite-code-font-family: 'Google Sans Mono', Roboto Mono, monospace; --devsite-primary-font-family: 'Google Sans Text', Roboto, sans-serif; --devsite-table-heading-font: 500 14px/20px 'Google Sans Text', Roboto, sans-serif; --googledevai-border-color: #c4c7c5; --googledevai-blue-light: #d7e6ff; --googledevai-blue-dark: #2e64de; --googledevai-cyan-light: #c7e4ff; --googledevai-cyan-dark: #3c8fe3; --googledevai-purple-light: #dce2ff; --googledevai-purple-dark: #987be9; --googledevai-purple: #ac87eb; --googledevai-red: #ee4d5d; --googledevai-secondary-text: #001d35; --googledevai-button-gradient-light: linear-gradient(90deg, var(--googledevai-blue-light), var(--googledevai-cyan-light), var(--googledevai-purple-light)); --googledevai-button-gradient-dark: linear-gradient(90deg, var(--googledevai-blue), var(--googledevai-cyan), var(--googledevai-purple)); } body[theme="googledevai-theme"]:not([type="reference"]){ --googledevai-page-width: 1100px; } body[theme="googledevai-theme"] .devsite-header-background { background: var(--googledevai-header-gradient); border-bottom: 1px solid #7e98d1; } body[theme="googledevai-theme"].color-scheme--dark .devsite-header-background { border-bottom: 1px solid var(--googledevai-border-color); } body[layout=docs][theme="googledevai-theme"]:not([type="reference"]) .devsite-main-content, body[layout=docs][theme="googledevai-theme"]:not([type="reference"]) .devsite-main-content[has-book-nav][has-sidebar] { grid-template-columns: minmax(269px, 1fr) minmax(752px, var(--googledevai-page-width)) minmax(160px, 1fr); grid-gap: 3rem; } body[layout=docs][theme="googledevai-theme"] devsite-content { max-width: var(--googledevai-page-width); } body[layout=docs][theme="googledevai-theme"] .devsite-article { box-shadow: unset; } body[theme="googledevai-theme"] { --googledevai-header-gradient: linear-gradient(90deg, var(--googledevai-blue) 50%, var(--googledevai-cyan), var(--googledevai-purple), var(--googledevai-red)); } body[theme="googledevai-theme"].color-scheme--dark { --googledevai-header-gradient: linear-gradient(90deg, var(--googledevai-blue) 75%, var(--googledevai-cyan), var(--googledevai-purple)); --googledevai-border-color: #444746; } /* Ensure that full-bleed pages get the full width. */ body[theme="googledevai-theme"][layout="full"] .devsite-main-content { max-width: none; padding: 0; } /* And ensure that any site banners/ACL warnings/etc don't get hidden on * full-bleed pages. */ body[theme="googledevai-theme"][layout="full"] .devsite-banner { margin: 0; } tab:has(> a.hidden-tab) { display: none; } .landing-page-card { padding: 16px; box-shadow: 0 0 36px rgba(0,0,0,0.1); border-radius: 10px; } /* Page section headings */ .landing-page-heading h2, h2.landing-page-heading { font-family: "Google Sans", sans-serif; color: #425066; font-size: 30px; font-weight: 700; line-height: 40px; } /* Item title headings */ .landing-page-heading h3, h3.landing-page-heading, .landing-page-card h3, h3.landing-page-card { font-family: "Google Sans", sans-serif; color: #425066; font-size: 20px; font-weight: 500; line-height: 26px; } body[theme="googledevai-theme"] devsite-toc > .devsite-nav-list { border-inline-start: unset; } /* Banner notice */ [layout=docs] .devsite-banner:first-of-type { background: var(--googledevai-cyan-light); border-radius: 10px; color: var(--googledevai-secondary-text); margin: -2.5rem -0.25rem 2.5rem; display: flex; } /* Banner notice smaller screens */ @media (max-width: 840px) { [layout=docs] .devsite-banner:first-of-type { margin: -0.25rem -0.25rem 2.5rem; } } /* Asides */ .devsite-article-body>aside:not([class*=attempt]) { border-radius: 2px; } /* Tables */ table:not(.tfo-notebook-buttons) { border: 1px solid var(--googledevai-border-color); border-collapse: unset; border-radius: 9px; margin: auto; width: 100%; } .gemini-api-model-table tr:not(:last-child) td:not(:first-child), .gemini-api-model-table tr:not(:last-child) th, th, table:not(.gemini-api-model-table):not(.tfo-notebook-buttons) tr:not(:last-child) td { border-bottom: 1px solid var(--googledevai-border-color); } th, td { background: transparent; padding: 1rem; } /* Notebooks */ devsite-code .tfo-notebook-code-cell-output { max-height: 300px; overflow: auto; background: rgba(237, 247, 255, 1); /* blue bg to distinguish from input code cells */ } devsite-code .tfo-notebook-code-cell-output + .devsite-code-buttons-container button { background: rgba(237, 247, 255, .7); /* blue bg to distinguish from input code cells */ } .color-scheme--dark devsite-code .tfo-notebook-code-cell-output { background: rgba(var(--devsite-background-2), 1); } .color-scheme--dark devsite-code .tfo-notebook-code-cell-output + .devsite-code-buttons-container button { background: rgba(var(--devsite-background-2), .7); } devsite-code[dark-code] .tfo-notebook-code-cell-output { background: rgba(64, 78, 103, 1); /* medium slate */ } devsite-code[dark-code] .tfo-notebook-code-cell-output + .devsite-code-buttons-container button { background: rgba(64, 78, 103, .7); /* medium slate */ } .devsite-article-body>devsite-code { --devsite-code-buttons-container-right: 0; --devsite-code-margin: 0 0; --devsite-code-padding-block: 14px; border-radius: 8px; } .devsite-article-body>.beta:not([class*=attempt]), .devsite-article-body>.caution:not([class*=attempt]), .devsite-article-body>.deprecated:not([class*=attempt]), .devsite-article-body>.dogfood:not([class*=attempt]), .devsite-article-body>.experimental:not([class*=attempt]), .devsite-article-body>.key-point:not([class*=attempt]), .devsite-article-body>.key-term:not([class*=attempt]), .devsite-article-body>.note:not([class*=attempt]), .devsite-article-body>.objective:not([class*=attempt]), .devsite-article-body>.preview:not([class*=attempt]), .devsite-article-body>.special:not([class*=attempt]), .devsite-article-body>.success:not([class*=attempt]), .devsite-article-body>.tip:not([class*=attempt]), .devsite-article-body>.warning:not([class*=attempt]), .devsite-article-body>aside:not([class*=attempt]) { --devsite-notice-margin: 0 0; border-radius: 8px; } /* override default table styles for notebook buttons */ .devsite-table-wrapper .tfo-notebook-buttons { display: inline-block; margin-left: 3px; width: auto; } .tfo-notebook-buttons td { padding-left: 0; padding-right: 20px; } /* on rendered notebook page, remove link to webpage since we're already here */ .tfo-notebook-buttons:not(.tfo-api) td:first-child { display: none; } .tfo-notebook-buttons a, .tfo-notebook-buttons :link, .tfo-notebook-buttons :visited { border-radius: 8px; box-shadow: 0 1px 2px 0 rgba(60, 64, 67, .3), 0 1px 3px 1px rgba(60, 64, 67, .15); color: #202124; padding: 12px 17px; transition: box-shadow 0.2s; } .tfo-notebook-buttons a:hover, .tfo-notebook-buttons a:focus { box-shadow: 0 1px 2px 0 rgba(60, 64, 67, .3), 0 2px 6px 2px rgba(60, 64, 67, .15); } .color-scheme--dark .tfo-notebook-buttons a, .color-scheme--dark .tfo-notebook-buttons :link, .color-scheme--dark .tfo-notebook-buttons :visited { background-color: #e0e0e0; box-shadow: 0 1px 2px 0 rgba(255, 255, 255, .3), 0 1px 3px 1px rgba(255, 255, 255, .15); } .color-scheme--dark .tfo-notebook-buttons a:hover, .color-scheme--dark .tfo-notebook-buttons a:focus { box-shadow: 0 1px 2px 0 rgba(255, 255, 255, .3), 0 2px 6px 2px rgba(255, 255, 255, .15); } .tfo-notebook-buttons tr { background: 0; border: 0; } .tfo-notebook-buttons td > a { -webkit-box-align: center; -ms-flex-align: center; align-items: center; display: -webkit-box; display: -ms-flexbox; display: flex; } .tfo-notebook-buttons td > a > img { margin-right: 8px; } /* remove this from the theme.scss file */ devsite-header { --devsite-header-color-lower: white !important; --devsite-header-foreground-lower: #ffffffc7 !important; --devsite-header-foreground-lower-hover: white !important; --devsite-header-foreground-lower-active: white !important; --devsite-lower-tab-marker-color-active: white !important; } devsite-nav-buttons button { margin-left: 0; margin-top: 5px; } code { border-radius: 6px } devsite-book-nav .devsite-nav-list>.devsite-nav-heading:not(.devsite-nav-divider) { border-top: 0; padding-bottom: 0.9rem; font-size: 1rem; } </style> <div class="devsite-banner devsite-banner-announcement nocontent" background="google-blue" > <div class="devsite-banner-message"> <div class="devsite-banner-message-text"> Native image generation with Gemini 2.0 Flash Experimental is now available! <a class="button button-primary" href="https://developers.googleblog.com/en/experiment-with-gemini-20-flash-native-image-generation/">Learn more</a> </div> </div> </div> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://ai.google.dev/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://ai.google.dev/gemini-api" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="Gemini API" > Gemini API </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://ai.google.dev/gemini-api/docs" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="" > Models </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://ai.google.dev/api" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="" > API Reference </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <devsite-feedback position="header" project-name="Gemini API" product-id="5292923" bucket="documentation" context="" version="t-devsite-webserver-20250320-r00-rc00.467841579120382285" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="header" class="nocontent" project-icon="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/touchicon-180-new.png" > <button> Send feedback </button> </devsite-feedback> <h1 class="devsite-page-title" tabindex="-1"> Gemini API reference <div class="devsite-actions" data-nosnippet> </div> </h1> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <p></p> <p>The Gemini API lets you access the latest generative models from Google. This API reference provides detailed information for the classes and methods available in the Gemini API SDKs. Pick a language and follow the setup steps to get started building.</p> <p><devsite-nav-buttons name="lang" param="always" type="filled"> <button value="python" default>Python</button> <button value="node">Node.js</button> <button value="go">Go</button> <button value="dart">Dart (Flutter)</button> <button value="android">Android</button> <button value="swift">Swift</button> <button value="web">Web</button> </devsite-nav-buttons></p> <h2 id="install-gemini-library" data-text="Install the Gemini API library" tabindex="-1">Install the Gemini API library</h2> <aside class="note"><strong>Note:</strong><span> We're rolling out a new set of Gemini API libraries, the <a href="/gemini-api/docs/sdks">Google Gen AI SDK</a>.</span></aside> <h2 id="make-first-request" data-text="Make your first request" tabindex="-1">Make your first request</h2> <p>Use the <a href="/api/generate-content#method:-models.generatecontent"><code translate="no" dir="ltr">generateContent</code></a> method to send a request to the Gemini API.</p> <h2 id="what's-next" data-text="What's next" tabindex="-1">What's next</h2> <p>If you're just getting started, check out the following guides, which will help you understand the Gemini API programming model:</p> <ul> <li><a href="/gemini-api/docs/quickstart">Gemini API quickstart</a></li> <li><a href="/gemini-api/docs/models/gemini">Gemini model guide</a></li> <li><a href="/gemini-api/docs/prompting-intro">Prompt design</a></li> </ul> <p>You might also want to check out the capabilities guides, which introduce different Gemini API features and provide code examples:</p> <ul> <li><a href="/gemini-api/docs/text-generation">Text generation</a></li> <li><a href="/gemini-api/docs/caching">Context caching</a></li> <li><a href="/gemini-api/docs/embeddings">Embeddings</a></li> <li><a href="/gemini-api/docs/model-tuning">Tuning</a></li> </ul> </div> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-feedback position="footer" project-name="Gemini API" product-id="5292923" bucket="documentation" context="" version="t-devsite-webserver-20250320-r00-rc00.467841579120382285" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="footer" class="nocontent" project-icon="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/touchicon-180-new.png" > <button> Send feedback </button> </devsite-feedback> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2025-03-24 UTC.</p> </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-thumb-rating-feedback"> <devsite-feedback position="thumb-rating" project-name="Gemini API" product-id="5292923" bucket="documentation" context="" version="t-devsite-webserver-20250320-r00-rc00.467841579120382285" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="thumb-rating" class="nocontent" project-icon="https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/touchicon-180-new.png" > <button> Need to tell us more? </button> </devsite-feedback> </template> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-03-24 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="sq" >Shqip</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [], "ga4p": [], "gtm": [{"id": "GTM-TC2MQKS8", "purpose": 0}], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "Gemini API", "signedIn": "False", "tenant": "googledevai", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="DSpFs5lCtAWVE5VJQnYcNGXKS8ad0x"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/js/app_loader.js', '[59,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933","https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai","https://googledevai-dot-devsite-v2-prod-3p.appspot.com",1,null,["/_pwa/googledevai/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/favicon-new.png","https://www.gstatic.com/devrel-devsite/prod/v17c4f87be230ffee20589ee6dca0a2318ead9eddb228ec5c58233202ff69a933/googledevai/images/lockup-new.svg","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,116,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyCNm9YxQumEXwGJgTDjxoxXK6m1F-9720Q","AIzaSyCc76DZePGtoyUjqKrLdsMGk_ry7sljLbY","ai.google.dev","AIzaSyB9bqgQ2t11WJsOX8qNsCQ6U-w91mmqF-I","AIzaSyAdYnStPdzjcJJtQ0mvIaeaMKj7_t6J_Fg",null,null,null,["Profiles__enable_complete_playlist_endpoint","MiscFeatureFlags__enable_variable_operator_index_yaml","MiscFeatureFlags__emergency_css","Cloud__enable_cloud_shell_fte_user_flow","Profiles__enable_release_notes_notifications","Profiles__enable_stripe_subscription_management","Cloud__enable_llm_concierge_chat","Cloud__enable_cloud_shell","MiscFeatureFlags__enable_firebase_utm","Profiles__enable_developer_profiles_callout","Search__enable_page_map","Profiles__enable_awarding_url","BookNav__enable_tenant_cache_key","MiscFeatureFlags__enable_view_transitions","CloudShell__cloud_code_overflow_menu","Search__enable_ai_eligibility_checks","MiscFeatureFlags__developers_footer_dark_image","Profiles__enable_dashboard_curated_recommendations","Analytics__enable_clearcut_logging","OnSwitch__enable","DevPro__enable_devpro_offers","Cloud__enable_cloud_facet_chat","MiscFeatureFlags__enable_framebox_badge_methods","MiscFeatureFlags__developers_footer_image","MiscFeatureFlags__enable_project_variables","Concierge__enable_pushui","Cloud__enable_cloudx_ping","Profiles__enable_public_developer_profiles","Cloud__enable_cloud_dlp_service","MiscFeatureFlags__enable_variable_operator","Profiles__enable_completecodelab_endpoint","Search__enable_dynamic_content_confidential_banner","Profiles__enable_profile_collections","Profiles__enable_page_saving","EngEduTelemetry__enable_engedu_telemetry","Concierge__enable_actions_menu","Profiles__enable_purchase_prompts","CloudShell__cloud_shell_button","Cloud__enable_cloudx_experiment_ids","Profiles__enable_join_program_group_endpoint","Profiles__enable_completequiz_endpoint","MiscFeatureFlags__enable_explain_this_code","Experiments__reqs_query_experiments","DevPro__enable_cloud_innovators_plus","Cloud__enable_free_trial_server_call","Profiles__require_profile_eligibility_for_signin","Search__enable_suggestions_from_borg","TpcFeatures__enable_unmirrored_page_left_nav","Cloud__enable_legacy_calculator_redirect","Profiles__enable_recognition_badges","DevPro__enable_developer_subscriptions","TpcFeatures__enable_mirror_tenant_redirects"],null,null,"AIzaSyA58TaKli1DculwmAmbpzLVGuWc8eCQgQc","https://developerscontentserving-pa.googleapis.com","AIzaSyDWBU60w0P9hEkr29kkksYs8Z7gvZ8u_wc","https://developerscontentsearch-pa.googleapis.com",2,4,null,"https://developerprofiles-pa.googleapis.com",[59,"googledevai","Google AI for Developers","ai.google.dev",null,"googledevai-dot-devsite-v2-prod-3p.appspot.com",null,null,[null,1,null,null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],null,null,null,null,[1],[1,1,null,1,1]],null,[73,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,1,1,1,null,null,null,null,null,null,null,2,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[44,2,4,6,7,12,14,15,17,18,20,21,22,23,28,29,32,37,39,40,43],null,[[],[1,1],null,1],[[null,null,null,null,null,["GTM-TC2MQKS8"],null,null,null,null,null,[["GTM-TC2MQKS8",1]],1]],null,4],null,null,1,null,"https://developerscontentinsights-pa.googleapis.com","AIzaSyBUwhBSZ2D08LlB5muaB5af2QQjzrjYbIw"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Gemini API reference | Google AI for Developers