این مرجع میانای برنامه‌سازی کاربردی، میاناهای برنامه‌سازی کاربردی تک‌تایی، جاری‌سازی، و هم‌زمان را که می‌توانید برای تعامل با مدل‌های Gemini استفاده کنید شرح می‌دهد. می‌توانید از REST API در هر محیطی که از درخواست‌های HTTP پشتیبانی می‌کند استفاده کنید. برای نحوه شروع به کار با اولین فراخوانی میانای برنامه‌سازی کاربردی، به راهنمای شروع به کار مراجعه کنید. اگر به‌دنبال مرجع‌های کتابخانه‌ها و کیت‌های توسعه نرم‌افزار مختص زبان ما هستید، به پیوند مربوط به آن زبان در پیمایش سمت راست در بخش مرجع‌های کیت توسعه نرم‌افزار بروید.
نقطه‌های پایانی اصلی
Gemini API براساس نقاط پایانی اصلی زیر سازمان‌دهی شده است:
- تعامل‌ها (
CreateInteraction) (توصیه‌شده): ابتدایی استاندارد توصیه‌شده برای ساختن با Gemini، بهینه‌شده برای گردش کارهای عاملی، مدیریت وضعیت سمت سرور، و مکالمه‌های چندوجهی و چندمرحله‌ای پیچیده. - تولید محتوای استاندارد (
generateContent): یک نقطه پایانی REST استاندارد که درخواست شما را پردازش می‌کند و پاسخ کامل مدل را در یک بسته برمی‌گرداند. این حالت برای کارهای غیرتعاملی که می‌توانید برای کل نتیجه منتظر بمانید بهترین است. - تولید محتوای جاری‌سازی (
streamGenerateContent): از «رویدادهای ارسال‌شده از سرور» (SSE) برای ارسال بخش‌هایی از پاسخ به شما درحین تولید استفاده می‌کند. این کار تجربه سریع‌تر و تعاملی‌تری برای برنامه‌هایی مثل روبات‌های گپ فراهم می‌کند. - Live API (
BidiGenerateContent): یک API مبتنی بر WebSocket با حفظ وضعیت برای جاری‌سازی دوطرفه که برای موارد استفاده مکالمه‌ای هم‌زمان طراحی شده است. - حالت دسته‌ای (
batchGenerateContent): یک نقطه پایانی REST استاندارد برای ارسال دسته‌های درخواست‌هایgenerateContent. - جاسازی‌ها (
embedContent): یک نقطه پایانی REST استاندارد که بردار جاسازی نوشتار را از ورودیContentتولید می‌کند. - میاناهای برنامه‌سازی کاربردی Gen Media: نقاط پایانی برای تولید رسانه با مدل‌های تخصصی ما مثل Imagen برای تولید تصویر و Veo برای تولید ویدیو.
Gemini همچنین این قابلیت‌های داخلی را دارد که می‌توانید بااستفاده از
generateContentAPI به آن‌ها دسترسی داشته باشید. - میاناهای برنامه‌سازی کاربردی پلاتفرم: نقاط پایانی کاربردی که از قابلیت‌های اصلی مانند بارگذاری فایل‌ها و شمارش نشان‌ها پشتیبانی می‌کنند.
اصالت‌سنجی
همه درخواست‌ها به Gemini API باید شامل سرصفحه x-goog-api-key با کلید میانای برنامه‌سازی کاربردی شما باشد. با چند کلیک در Google AI
Studio یکی بسازید.
در زیر یک درخواست نمونه با کلید میانای برنامه‌سازی کاربردی در سرایند آورده شده است:
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.8-flash",
"input": "Explain how AI works in a few words"
}'
برای دریافت دستورالعمل‌های مربوط به نحوه ارسال کلید به میانای برنامه‌سازی کاربردی بااستفاده از «کیت‌های توسعه نرم‌افزار Gemini»، راهنمای استفاده از کلیدهای Gemini API را ببینید.