۱۰۰ هزار تومان هدیهٔ ثبت‌نام، تا ۱ میلیونبا ثبت‌نام گردونهٔ هدیه را بچرخان: دست‌کم ۱۰۰٬۰۰۰ تومان و تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه، بدون کارت بانکیگردونهٔ هدیه۱ میلیون برای تو، ۱ میلیون برای دوستتدوستانت را دعوت کن: برای هر دوستی که فعال شود ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه می‌گیری و خودش هم ۱٬۰۰۰٬۰۰۰ تومانجوایز
1xAi
مستندات API

مسیر نیتیو Gemini: generateContent، استریم و ساخت ویدیو

https://1xai.ir/gemini/v1beta/models/{model}:generateContent بدنهٔ درخواست را به Generative Language API رسمی Google می‌فرستد و usageMetadata کامل را برمی‌گرداند. کلید 1xai-* باید در هدر x-goog-api-key یا Authorization: Bearer باشد، نه در نشانی. کش ضمنی Gemini خودکار است و تخفیفش در صورت‌حساب اعمال می‌شود؛ کش صریح (cachedContents) پشتیبانی نمی‌شود.

آخرین به‌روزرسانی:

فهرست مستندات

Gemini (نیتیو) · ۱

generateContent و streamGenerateContent

POST /gemini/v1beta/models/{model}:generateContent
curl
curl https://1xai.ir/gemini/v1beta/models/gemini-3.5-flash:generateContent \
  -H "x-goog-api-key: 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "این متن را در یک پاراگراف خلاصه کن."}]}
    ],
    "generationConfig": {"maxOutputTokens": 1024, "temperature": 0.3}
  }'

کتابخانهٔ رسمی Google GenAI

Python
from google import genai
from google.genai import types

client = genai.Client(
    api_key="1xai-...",
    http_options=types.HttpOptions(base_url="https://1xai.ir/gemini"),
)

resp = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="سلام",
)
print(resp.text)
  • نسخه‌های v1beta و v1 پذیرفته می‌شوند.
  • بدنه همان بدنهٔ Google است: contents، systemInstruction، generationConfig، tools، safetySettings.
  • هزینه از usageMetadata حساب می‌شود: توکن پرامپت، توکن خروجی و توکن فکر؛ cachedContentTokenCount با نرخ ارزان‌تر کش.
  • اگر اعتبار کفاف maxOutputTokens را ندهد، دروازه آن را پایین می‌آورد، مثل مسیرهای دیگر.
  • از پارامترهای نشانی فقط alt، fields و prettyPrint به Google می‌رسند. برای استریم به شکل SSE، :streamGenerateContent?alt=sse را صدا بزن.
  • اگر Google 429، 503 یا 529 بدهد، دروازه تا ۳ بار تلاش می‌کند.

Gemini (نیتیو) · ۲

مسیرهای رایگان

  • POST …/models/{model}:countTokens: شمارش توکن پیش از فرستادن.
  • GET /gemini/v1beta/models و GET /gemini/v1beta/models/{model}: فهرست و مشخصات مدل‌ها.

Gemini (نیتیو) · ۳

grounding و ساخت تصویر

  • grounding با Google Search مجاز است و جدا از توکن‌ها، با نرخ جست‌وجوی همان مدل حساب می‌شود. grounding با Google Maps خطای 402 با کد hosted_tool_unmetered می‌گیرد (ابزارهای سمت سرور).
  • مدل‌های تصویر Google را با همین :generateContent صدا بزن؛ تصویر در inlineData پاسخ می‌آید و بر اساس توکن حساب می‌شود.

Gemini (نیتیو) · ۴

ساخت ویدیو با Gemini Omni

POST /gemini/v1beta/interactions
curl
curl https://1xai.ir/gemini/v1beta/interactions \
  -H "x-goog-api-key: 1xai-..." \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "gemini-omni-1.1-flash",
    "input": "موج آرام دریا در غروب",
    "response_format": {"type": "video", "duration": "8s"}
  }'
  • این درخواست هم‌زمان است: پاسخ وقتی می‌رسد که ویدیو ساخته شده و خود ویدیو به‌صورت base64 در steps همان پاسخ است.
  • background، "store": true و "delivery": "uri" پذیرفته نمی‌شوند و خطای 400 با کد invalid_request می‌گیرند، چون ویدیو جایی نگه داشته نمی‌شود. این خطا هزینه‌ای ندارد.
  • مدت با duration یکی از 4s، 6s یا 8s است و وضوح 720p. ورودی: متن، یا متن با تصویر درون‌خطی.
  • هزینه بر اساس ثانیهٔ ویدیو است و فقط وقتی کم می‌شود که ویدیو ساخته شده باشد.
  • اگر اتصال را پیش از رسیدن پاسخ ببندی، ویدیوی ساخته‌شده حساب می‌شود و دیگر قابل دریافت نیست. مهلت کلاینت را چند دقیقه بگذار.
  • مدل‌های Veo را سازنده بازنشسته کرده است و :predictLongRunning با آن‌ها 410 با کد model_retired می‌گیرد.

Gemini (نیتیو) · ۵

آنچه در این مسیر نیست

cachedContents، بارگذاری فایل، پردازش دسته‌ای، :embedContent و نسخه‌های دیگر API پذیرفته نمی‌شوند. فهرست کامل در پشتیبانی‌نشده‌ها است. برای امبدینگ از POST /v1/embeddings استفاده کن.