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

EFARS API

GenerateContent

مرجع درخواست و پاسخ Gemini با مثال‌های curl، Python و JavaScript.

راهنمای اتصال مشتریان
curl · Python · JavaScript

آدرس و احراز هویت

HTTP

POST https://efars.com/gemini/v1beta/models/GEMINI_MODEL_NAME:generateContent
x-goog-api-key: YOUR_EFARS_API_KEY
Content-Type: application/json

نمونه‌ها آموزشی‌اند و حاصل اجرای زنده نیستند. YOUR_EFARS_API_KEY و نام‌های ختم‌شونده به MODEL_NAME جای‌نگهدارند؛ پیش از اجرا، کلید ای‌فارس و مدل مجاز حساب خود را جایگزین کنید. مقادیر شناسه و مصرف در پاسخ‌های نمونه، گزارش مصرف واقعی نیستند.

پارامترهای درخواست

پارامترنوع و الزامتوضیح
model (در URL)string · الزامینام دقیق مدل را به جای GEMINI_MODEL_NAME در مسیر قرار دهید؛ در بدنه model نفرستید.
contentsarray · الزامیپیام‌ها با role برابر user یا model و آرایه parts؛ در نمونه متنی هر part یک text دارد.
generationConfigobject · اختیاریتنظیمات تولید، شامل maxOutputTokens، temperature و topP در مدل‌های سازگار.
systemInstructionobject · اختیاریدستور سیستمی با ساختار parts شامل text.
safetySettingsarray · اختیاریتنظیمات ایمنی در حدود پشتیبانی و سیاست مدل.
tools / toolConfigarray / object · اختیاریابزارهای سازگار؛ وجود فیلد به معنای پشتیبانی همه مدل‌ها نیست.
عملیات streamingبخش مسیربه جای stream:true از :streamGenerateContent?alt=sse استفاده کنید.

ساختار درخواست

JSON

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "سلام! لطفاً خودت را معرفی کن."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 256
  }
}

نمونه کد اتصال

این کدها برای محیط امن سمت سرور هستند. درخواست مصرفی را فقط پس از جایگزینی مدل و کلید و بررسی دسترسی و تعرفه ارسال کنید.

curl

# مدل جای‌نگهدار را با مدل مجاز حساب خود جایگزین کنید.
curl --fail-with-body 'https://efars.com/gemini/v1beta/models/GEMINI_MODEL_NAME:generateContent' \
  -H "x-goog-api-key: ${EFARS_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "سلام! لطفاً خودت را معرفی کن."
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 256
  }
}'

ساختار پاسخ

JSON

{
  "candidates": [
    {
      "index": 0,
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "سلام! من Gemini، مدل هوش مصنوعی Google هستم. می‌توانم در تحلیل اطلاعات، تولید محتوا، برنامه‌نویسی و انجام وظایف مختلف به شما کمک کنم."
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}

مسیر استخراج متن: candidates[].content.parts[].text. این نمونه فقط پاسخ متنی را نمایش می‌دهد؛ نوع بلوک‌ها و علت پایان را پیش از خواندن متن بررسی کنید.

ممکن است candidates یا parts متن نداشته باشند. finishReason، promptFeedback و safetyRatings را بررسی کنید. مسدودشدن محتوا را به‌عنوان پاسخ متنی موفق و کامل نمایش ندهید.

Streaming و خطاها