مدل‌ها

دریافت یک مدل در قالب Gemini

مشخصات یک مدل چت در قالب Google (models.get): نام، محدودیت توکن ورودی و خروجی و متدهای پشتیبانی‌شده.

GET/v1beta/models/{model}

نام مدل را بدون پیشوند models/ بنویسید. برای مدل‌های Google هم gemini-3.8-flash و هم google/gemini-3.8-flash پذیرفته می‌شود. مدل سازنده‌های دیگر را با نام کامل بنویسید.

فقط مدل‌های چت جواب می‌دهند. شناسه‌ی مدل غیرچت (مثل بردار متن) یا مدلی که به آن دسترسی ندارید، 404 می‌دهد.

supportedGenerationMethods همیشه همین سه مقدار است: generateContent، streamGenerateContent و countTokens.

نمونه‌ها

curl https://1ai.ir/v1beta/models/gemini-3.8-flash \
  -H "x-goog-api-key: $ONEAI_API_KEY"
200پاسخ
{
  "name": "models/gemini-3.8-flash",
  "version": "1",
  "displayName": "Gemini 3.8 Flash",
  "description": "A fast multimodal model.",
  "inputTokenLimit": 1000000,
  "outputTokenLimit": 64000,
  "supportedGenerationMethods": [
    "generateContent",
    "streamGenerateContent",
    "countTokens"
  ]
}

پارامترهای مسیر

  • modelstringالزامی

    نام مدل، مثل gemini-3.8-flash. پیشوند models/ لازم نیست.

پارامترهای کوئری

  • keystring

    کلید API در آدرس، به‌جای سرآیند.

خطاها

  • UNAUTHENTICATED401

    کلید نامعتبر، لغوشده یا منقضی است.

  • NOT_FOUND404

    چنین مدل چتی نیست یا کلید به آن دسترسی ندارد.

صفحه‌های مرتبط