API تعاملات اکنون به طور عمومی در دسترس است. توصیه میکنیم برای دسترسی به جدیدترین ویژگیها و مدلها از این API استفاده کنید.
Gemini API
ما استفاده از Interactions API را برای همه پروژههای جدید توصیه میکنیم. این API برای گردشهای کاری عاملمحور، مدیریت وضعیت و جدیدترین مدلها بهینه شده است. برای اطلاعات بیشتر به Interactions API Overview مراجعه کنید.
سریعترین مسیر از سفارش تا تولید با Gemini، Veo، Nano Banana و موارد دیگر.
پایتون
from google import genai
client = genai . Client ()
interaction = client . interactions . create (
model = "gemini-3.5-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.5-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.5-flash",
"input": "Explain how AI works in a few words"
}'
شروع به ساختن کنید برای دریافت کلید API و برقراری اولین فراخوانی API خود در عرض چند دقیقه، راهنمای شروع سریع ما را دنبال کنید.
auto_awesome جمینی ۳.۱ پرو
جدید هوشمندترین مدل ما، بهترین مدل در جهان برای درک چندوجهی، که همگی بر اساس استدلال پیشرفته ساخته شدهاند.
spark جمینی ۳.۵ فلش
جدید عملکردی در سطح کلاس Frontier که با کسری از قیمت، مدلهای بزرگتر را به رقابت میخواند.
spark جمینی ۳.۱ فلش-لایت
جدید مدلی با تیراژ بالا و قیمت مناسب با عملکرد و کیفیت سری Gemini 3.
spark Gemini 3 فلش
عملکردی در سطح کلاس Frontier که با کسری از قیمت، مدلهای بزرگتر را به رقابت میخواند.
🍌 نانو موز ۲ و نانو موز پرو
مدلهای پیشرفته تولید و ویرایش تصویر.
video_library وئو ۳.۱
مدل تولید ویدیوی پیشرفته ما، با صدای بومی.
spark رباتیک جمینی
یک مدل زبان بینایی (VLM) که قابلیتهای عاملمحور Gemini را به رباتیک میآورد و استدلال پیشرفته در دنیای فیزیکی را امکانپذیر میکند.
بررسی قابلیتها imagesmode
تولید تصویر بومی (نانو موز)
با استفاده از Gemini 2.5 Flash Image، تصاویر بسیار متنی را به صورت بومی تولید و ویرایش کنید.
article متن طولانی
میلیونها توکن را به مدلهای Gemini وارد کنید و از تصاویر، ویدیوها و اسناد بدون ساختار، درک لازم را به دست آورید.
code خروجیهای ساختاریافته
Gemini را مجبور کنید تا با JSON پاسخ دهد، یک فرمت داده ساختار یافته مناسب برای پردازش خودکار.
functions فراخوانی تابع
با اتصال Gemini به APIها و ابزارهای خارجی، گردشهای کاری عاملمحور بسازید.
videocam تولید ویدیو با Veo 3.1
با استفاده از مدل پیشرفته ما، محتوای ویدیویی با کیفیت بالا از متن یا تصویر ایجاد کنید.
android_recorder عاملهای صوتی با API زنده
با استفاده از Live API، اپلیکیشنها و عاملهای صوتی بلادرنگ بسازید.
build ابزارها
Gemini را از طریق ابزارهای داخلی مانند جستجوی گوگل، متن URL، نقشههای گوگل، اجرای کد و استفاده از رایانه به جهان متصل کنید.
stacks درک سند
پردازش تا ۱۰۰۰ صفحه فایل PDF با درک کامل چندوجهی یا سایر انواع فایلهای مبتنی بر متن.
cognition_2 تفکر
بررسی کنید که چگونه قابلیتهای تفکر، استدلال برای وظایف و عاملهای پیچیده را بهبود میبخشد.
استودیوی هوش مصنوعی گوگل
اعلانها را آزمایش کنید، کلیدهای API خود را مدیریت کنید، میزان استفاده را زیر نظر داشته باشید و نمونههای اولیه بسازید.
group جامعه توسعهدهندگان
از دیگر توسعهدهندگان و مهندسان گوگل سوال بپرسید و راهحل پیدا کنید.
menu_book مرجع API
اطلاعات دقیق در مورد API مربوط به Gemini را در مستندات مرجع رسمی بیابید.
sensors وضعیت
وضعیت Gemini API، Google AI Studio و سرویسهای مدل ما را بررسی کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2026-06-22 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-06-22 بهوقت ساعت هماهنگ جهانی."],[],[]]