مدل‌ها

فهرست مدل‌ها در قالب Gemini

فهرست مدل‌های چت در قالب Google (models.list) برای کتابخانه‌ها و ابزارهایی که با Gemini API کار می‌کنند، با صفحه‌بندی pageSize و pageToken.

GET/v1beta/models

این مسیر برای ابزارهای قالب Gemini (مثل Gemini CLI) است. فقط مدل‌های چت که کلید اجازه‌شان را دارد می‌آیند. برای فهرست همه‌ی نوع‌ها از فهرست مدل‌ها استفاده کنید.

کلید را با x-goog-api-key، پارامتر آدرس key یا هر یک از روش‌های احراز هویت بفرستید. خطاها در قالب Google برمی‌گردند.

نام هر مدل models/<نام> است و پیشوند google/ برای مدل‌های Google حذف می‌شود: google/gemini-3.8-flash به models/gemini-3.8-flash تبدیل می‌شود. مدل سازنده‌های دیگر با نام کامل می‌آیند، مثل models/anthropic/claude-sonnet-5.5.

صفحه‌بندی: pageSize تعداد هر صفحه است و اگر صفحه‌ی بعدی هست، nextPageToken در پاسخ می‌آید. همان مقدار را در pageToken بفرستید. بدون pageSize، همه‌ی مدل‌ها یک‌جا برمی‌گردند.

نمونه‌ها

curl "https://1ai.ir/v1beta/models?pageSize=2" \
  -H "x-goog-api-key: $ONEAI_API_KEY"
200پاسخ
{
  "models": [
    {
      "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"
      ]
    },
    {
      "name": "models/gemini-3.5-flash-lite",
      "version": "1",
      "displayName": "Gemini 3.5 Flash Lite",
      "description": "A light, low-latency model.",
      "inputTokenLimit": 1000000,
      "outputTokenLimit": 32000,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    }
  ],
  "nextPageToken": "2"
}

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

  • pageSizeinteger

    تعداد مدل در هر صفحه. بدون آن همه‌ی مدل‌ها می‌آیند.

  • pageTokenstring

    توکن صفحه‌ی بعد، همان nextPageToken پاسخ قبلی.

  • keystring

    کلید API در آدرس، به‌جای سرآیند. فقط روی /v1beta پذیرفته می‌شود.

خطاها

  • UNAUTHENTICATED401

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

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