#API tương thích Gemini

GetRouter cung cấp các endpoint liệt kê model và tạo nội dung tương thích với Gemini.

GET  https://getrouter.ai/v1beta/models
POST https://getrouter.ai/v1beta/models/{model}:generateContent

Thay {model} bằng model ID chính xác.

#Liệt kê model

curl https://getrouter.ai/v1beta/models \
  -H "x-goog-api-key: YOUR_API_KEY"

Phản hồi sử dụng cấu trúc danh sách model tương thích với Gemini.

#Tạo nội dung

curl "https://getrouter.ai/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {"text": "Explain API routing in two sentences."}
        ]
      }
    ],
    "generationConfig": {
      "temperature": 0.4,
      "maxOutputTokens": 256
    }
  }'

Nội dung được tạo nằm trong cấu trúc candidates tương thích với Gemini. Thông tin sử dụng có thể được trả về trong usageMetadata.

#Các trường yêu cầu

Lược đồ generateContent gồm:

• contents với vai trò user hoặc model
• Các phần văn bản
• Các phần dữ liệu nội tuyến có mimeType và data ở dạng Base64
• generationConfig, gồm temperature, top-p, top-k, số token đầu ra tối đa và chuỗi dừng
• safetySettings
• tools
• systemInstruction

Khả năng hỗ trợ thay đổi theo model. Hãy bắt đầu với nội dung chỉ có văn bản trước khi thêm đầu vào đa phương thức, công cụ hoặc cấu hình dành riêng cho model.

#Ví dụ về dữ liệu nội tuyến

Model đa phương thức tương thích có thể chấp nhận một phần dữ liệu nội tuyến:

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {"text": "Describe the attached image."},
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ]
}

#Nội dung yêu cầu tạo hình ảnh Gemini

Cùng đường dẫn generateContent có thể cung cấp cấu hình phản hồi dành cho hình ảnh cho các model tương thích, gồm phương thức phản hồi và cấu hình hình ảnh. Với các yêu cầu này, hãy dùng đúng tài liệu của model và ví dụ trong Tài liệu tham chiếu API.

#Lưu ý về tính tương thích

• Client tương thích với Gemini có thể tạo URL theo cách khác với client tương thích với OpenAI.
• Không nhập https://getrouter.ai/v1 vào client Gemini, trừ khi hướng dẫn tích hợp yêu cầu rõ ràng giá trị đó.
• Xác nhận client cần đường dẫn gốc API, đường dẫn phiên bản API hay endpoint thao tác đầy đủ.

#Bước tiếp theo

• Bắt đầu nhanh với công cụ
• Duyệt model
• Xem giá
• Mở Tài liệu tham chiếu API