ویرگول
ورودثبت نام
Amirhossein Nouri
Amirhossein Nouri
Amirhossein Nouri
Amirhossein Nouri
خواندن ۲ دقیقه·۳ ماه پیش

Gemini API را بدون VPN و با تومان بکار ببرید: راهنمای نصب و اولین درخواست

Gemini API In 5 Minutes

⁦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

python
۰
۰
Amirhossein Nouri
Amirhossein Nouri
شاید از این پست‌ها خوشتان بیاید