
Gemini API یک رابط REST و SDK از گوگل است که مدلهای Gemini را مستقیماً در کد شما قرار میدهد — بدون نیاز به Google AI Studio یا رابط وب. درخواست را از کلاینت (پایتون یا جاوااسکریپت) با کلید API به سرورها ارسال میکنید، مدل پاسخ JSON برمیگردد و میتوانید آن را در چتبات، موتور جستوجو یا سیستم تحلیل خودتان ادغام کنید.
مشکل اصلی برای توسعهدهندگان ایرانی این نیست که Gemini API چیست، بلکه دسترسی پایدار و پرداخت تومانی است. 1xAi یک gateway اداره میکند که مدلهای Gemini را از طریق یک رابط سازگار با OpenAI در ` فراهم میکند — بدون نیاز به کارت بینالمللی یا VPN. فهرست مدلهای دستیاب در صفحه مدلهای 1xAi بهروز میماند.
https://1xai.ir/v1`
چه مدلهای Gemini در دسترساند؟ در حال حاضر gemini-2.5-flash-lite، gemini-2.5-flash، gemini-3.5-flash و gemini-2.5-pro موجوداند. برای اپلیکیشنهای حساس به هزینه و تأخیر، gemini-2.5-flash-lite ارزانترین گزینه است — قیمت ورودی و خروجی آن در صفحه قیمتگذاری 1xAi درج شده و بهصورت تومان محاسبه میشود. برای وظایفی که دقت بیشتر مهم است، gemini-2.5-pro مناسبتر است اما هزینه بالاتری دارد.
اولین درخواست چطور کار میکند؟ کلاینت درخواستی با یک پیام و مدلنام به سرور میفرستد، سرور آن را پردازش میکند و JSON با پاسخ برمیگردد. کد ساده در پایتون:
from openai import OpenAI
client = OpenAI(
api_key="YOUR_1XAI_API_KEY",
base_url="https://1xai.ir/v1"
)
response = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[
{"role": "user", "content": "سلام، چطور میتونم Gemini API رو استفاده کنم؟"}
]
)
print(response.choices[0].message.content)
این کد کتابخانه OpenAI رسمی را استفاده میکند اما base_url را به gateway 1xAi اشاره میدهد. هر جا که در مستندات OpenAI از دیدید، در اینجا میگذارید.
https://api.openai.com/v1`
https://1xai.ir/v1`
SDK نصب کردن آسان است. در ترمینال:
pip install openai
سپس کلید API خود را از 1xAi دریافت کنید و در متغیر محیط یا مستقیم در کد قرار دهید. درخواست اول را اجرا کنید و پاسخ را ببینید.
اگر نیاز به یکپارچهسازی پیچیدهتر دارید — مثل چتبات تخصصی یا اتوماسیون سفارشی — میتوانید از طریق فرم درخواست سفارشی 1xAi تماس بگیرید.
راهنمای کامل، شامل مثالهای بیشتر و تشریح معماری API: — منتشرشده توسط 1xAi (1xai.ir).
https://1xai.ir/blog/gemini-api-rahname-nasb-sdk