Gemini API

رابط برنامه‌نویسی نرم‌افزار Gemini سریع‌ترین مسیر از اعلان تا تولید با Gemini، Veo، Nano Banana و موارد دیگر است. این رابط به شما امکان می‌دهد این مدل‌های مولد را در برنامه‌های خود ادغام کنید تا متن و تصاویر تولید کنید، ورودی‌های چندوجهی را تجزیه و تحلیل کنید و عامل‌های محاوره‌ای بسازید.

پایتون

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.7-flash",
    input="Explain how AI works in a few words"
)

print(interaction.output_text)

جاوا اسکریپت

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.7-flash",
  input: "Explain how AI works in a few words",
});

console.log(interaction.output_text);

استراحت

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gemini-3.7-flash",
    "input": "Explain how AI works in a few words"
  }'
شروع به ساختن کنید

برای دریافت کلید API و برقراری اولین فراخوانی API خود در عرض چند دقیقه، راهنمای شروع به کار ما را دنبال کنید.


با مدل‌ها آشنا شوید

مشاهده همه

کاوش در قابلیت‌ها

تولید تصویر بومی (نانو موز)

با استفاده از Gemini 2.5 Flash Image، تصاویر بسیار متنی را به صورت بومی تولید و ویرایش کنید.

متن طولانی

میلیون‌ها توکن را به مدل‌های Gemini وارد کنید و از تصاویر، ویدیوها و اسناد بدون ساختار، درک لازم را به دست آورید.

خروجی‌های ساختاریافته

Gemini را مجبور کنید تا با JSON پاسخ دهد، یک فرمت داده ساختار یافته مناسب برای پردازش خودکار.

فراخوانی تابع

با اتصال Gemini به APIها و ابزارهای خارجی، گردش‌های کاری عامل‌محور بسازید.

تولید ویدیو با Veo 3.1

با استفاده از مدل پیشرفته ما، محتوای ویدیویی با کیفیت بالا را از متن یا تصویر ایجاد کنید.

عامل‌های صوتی با API زنده

با Live API، اپلیکیشن‌ها و عامل‌های صوتی بلادرنگ بسازید.

ابزارها

Gemini را از طریق ابزارهای داخلی مانند جستجوی گوگل، متن URL، نقشه‌های گوگل، اجرای کد و استفاده از رایانه به جهان متصل کنید.

درک سند

پردازش تا ۱۰۰۰ صفحه فایل PDF با درک کامل چندوجهی یا سایر انواع فایل‌های مبتنی بر متن.

تفکر

بررسی کنید که چگونه قابلیت‌های تفکر، استدلال برای وظایف و عامل‌های پیچیده را بهبود می‌بخشد.

API تعاملات

از ژوئن ۲۰۲۶، رابط برنامه‌نویسی کاربردی (API) تعاملات (Interactions API) به رابط پیش‌فرض ما تبدیل شده است و بهترین راه برای ساخت مدل‌ها و عامل‌های Gemini در آینده است. اگر در حال شروع یک پروژه جدید هستید، باید از API تعاملات (Interactions API) استفاده کنید. در حالی که همچنان پشتیبانی می‌شود، API generateContent API) اکنون به عنوان یک رابط قدیمی در نظر گرفته می‌شود.

مرور کلی تعاملات

بیاموزید که چگونه API تعاملات، وضعیت مکالمه، پیام‌ها و قالب‌های خروجی را مدیریت می‌کند.

راهنمای مهاجرت

راهنمای گام به گام برای انتقال کد شما از generateContent به Interactions API.

پخش جریانی

توکن‌ها، افکار افزایشی و رویدادهای فراخوانی ابزار را به صورت بلادرنگ پخش کنید.

استودیوی هوش مصنوعی گوگل

اعلان‌ها را آزمایش کنید، کلیدهای API خود را مدیریت کنید، میزان استفاده را زیر نظر داشته باشید و نمونه‌های اولیه بسازید.

جامعه توسعه‌دهندگان

از دیگر توسعه‌دهندگان و مهندسان گوگل سوال بپرسید و راه‌حل پیدا کنید.

مرجع API

اطلاعات دقیق در مورد API مربوط به Gemini را در مستندات مرجع رسمی بیابید.

وضعیت

وضعیت Gemini API، Google AI Studio و سرویس‌های مدل ما را بررسی کنید.