مستندات 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) پشتیبانی نمیشود.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
Gemini (نیتیو) · ۱
generateContent و streamGenerateContent
POST /gemini/v1beta/models/{model}:generateContent
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
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 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 استفاده کن.