GenerateContent
مرجع درخواست و پاسخ Gemini با مثالهای 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 نفرستید. |
| contents | array · الزامی | پیامها با role برابر user یا model و آرایه parts؛ در نمونه متنی هر part یک text دارد. |
| generationConfig | object · اختیاری | تنظیمات تولید، شامل maxOutputTokens، temperature و topP در مدلهای سازگار. |
| systemInstruction | object · اختیاری | دستور سیستمی با ساختار parts شامل text. |
| safetySettings | array · اختیاری | تنظیمات ایمنی در حدود پشتیبانی و سیاست مدل. |
| tools / toolConfig | array / 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 را بررسی کنید. مسدودشدن محتوا را بهعنوان پاسخ متنی موفق و کامل نمایش ندهید.