مستندات

ورودی بومی Gemini

SDK گوگل را دست نزنید؛ آدرس پایه را روی /genai بگذارید.

POSThttps://iranrouter.com/genai/v1beta/models/{model}:generateContent

POSThttps://iranrouter.com/genai/v1beta/models/{model}:streamGenerateContent

SDK گوگل (google-genai) را دست نزنید؛ فقط آدرس پایه‌اش را روی /genai بگذارید. مدل و حالت stream در خودِ مسیر می‌آیند، همان‌طور که گوگل تعریف کرده.

python

from google import genai

client = genai.Client(
    api_key="ir-...",
    http_options={"base_url": "https://iranrouter.com/genai"},
)
resp = client.models.generate_content(
    model="google/gemini-2.5-pro",
    contents="سلام",
)

چه چیزی ترجمه می‌شود

contents / systemInstruction / generationConfig و ابزارها در هر دو جهت، به‌همراه usageMetadata در پاسخ.
تصویر به‌صورت inline_data (base64) یا file_data.file_uri.
احراز هویت با x-goog-api-key یا Authorization — هر دو کار می‌کنند، و مقدارش کلید ir- شماست.

گزینه‌هایی که معادل صادقی در مسیر اصلی ما ندارند حذف می‌شوند، نه حدس زده: topK، safetySettings، responseSchema، cachedContent و بودجهٔ thinking. اگر به آن‌ها نیاز دارید، مدل را از chat/completions صدا بزنید و پارامترها را همان‌جا بدهید. همچنین models.list() کار می‌کند و همان کاتالوگ GET /v1/models را در قالب گوگل برمی‌گرداند؛ countTokens پیاده‌سازی نشده و با خطای خودِ گوگل رد می‌شود.