TokenLab

Gemini gốc

Liệt kê các Model

Liệt kê các model khả dụng sử dụng định dạng Google Gemini API

GET
/v1beta/models

Trả về các model chấp nhận yêu cầu Gemini, theo định dạng Google Gemini API. Trường supportedGenerationMethods của mỗi model liệt kê các hành động mà bạn có thể gọi trên model đó.

Tham số Truy vấn (Query Parameters)

pageSizeintegerquery

Số lượng model tối đa cần trả về. Mặc định: 50, tối đa: 1000.

pageTokenstringquery

Token tiếp nối được trả về từ trang trước. Truyền lại giá trị này mà không thay đổi để lấy phần dữ liệu tiếp theo.

Xác thực (Authentication)

Không yêu cầu xác thực đối với các endpoint đọc danh mục model công khai.

Các gợi ý xác thực kiểu Gemini như ?key= hoặc x-goog-api-key không làm thay đổi hợp đồng phản hồi tại đây.

Phản hồi (Response)

modelsarray

Mảng các đối tượng model. Xem Lấy Model để biết các trường chi tiết.

nextPageTokenstring

Được trả về khi có thêm model khả dụng. Truyền giá trị này dưới dạng pageToken để tiếp tục phân trang.

Lỗi (Errors)

  • pageToken không hợp lệ sẽ trả về 400 INVALID_ARGUMENT.
  • Các lỗi liệt kê không mong muốn sẽ trả về 500 INTERNAL.

Yêu cầu

curl "https://api.tokenlab.sh/v1beta/models?pageSize=2" \
  -H "x-goog-api-key: sk-your-api-key"

Phản hồi

Response
{
  "models": [
    {
      "name": "models/gemini-2.5-flash",
      "baseModelId": "gemini-2.5-flash",
      "version": "gemini-2.5-flash",
      "displayName": "Gemini 2.5 Flash",
      "description": "Fast Gemini workhorse for multimodal apps where latency and price matter",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    },
    {
      "name": "models/gemini-2.5-flash-lite",
      "baseModelId": "gemini-2.5-flash-lite",
      "version": "gemini-2.5-flash-lite",
      "displayName": "Gemini 2.5 Flash-Lite",
      "description": "Lean Gemini 2.5 lane for cheap multimodal traffic and quick agents",
      "inputTokenLimit": 1048576,
      "outputTokenLimit": 65536,
      "supportedGenerationMethods": [
        "generateContent",
        "streamGenerateContent",
        "countTokens"
      ]
    }
  ],
  "nextPageToken": "b2Zmc2V0OjI"
}

Tham số truy vấn

pageSize?integer

Số lượng model tối đa cần trả về. Mặc định: 50.

Phạm vi1 <= value <= 1000
mặc định50
pageToken?string

Token tiếp tục từ trang trước. Một token không hợp lệ sẽ trả về 400.

Phản hồi

application/json

application/json

application/json