API هوش مصنوعی بدون فیلتر و بدون تحریم — بدون VPN در کد شما

هر توسعه‌دهنده‌ای در ایران این چرخه را دیده است: SDK رسمیِ OpenAI پشتِ فیلترینگ به خطای اتصال می‌خورد، تحریم‌ها درخواست‌های با منشأ ایران را مسدود می‌کنند، و پرداخت هم بدونِ کارتِ ارزی اصلاً ممکن نیست. راه‌حلِ رایج — تونل‌کردنِ ترافیکِ سرور از VPN — برای یک اسکریپتِ شخصی شاید کافی باشد، اما برای سرویسی که کاربر دارد یعنی:

• یک نقطهٔ شکستِ اضافه. هر قطعیِ VPN مستقیماً قطعیِ محصولِ توست — وسطِ شب، بدونِ اخطار.
• ریسکِ حساب. اتصال از IPهای اشتراکی و در گردش، همان الگویی است که سرویس‌دهنده‌ها برای بستنِ حساب رصد می‌کنند.
• بن‌بستِ پرداخت. حتی با اتصالِ برقرار، شارژِ حسابِ ارائه‌دهنده کارتِ بین‌المللی می‌خواهد — چیزی که در ایران در دسترس نیست.
• تأخیر و ناپایداری. مسیرِ چندپرشِ VPN یعنی latency بالاتر و timeoutهای تصادفی — سمی برای هر جریانِ استریم.

در کدِ تو فقط یک چیز عوض می‌شود: آدرسِ پایه به https://1xai.ir/v1 اشاره می‌کند (و برای SDKهای نیتیو، مسیرهای /anthropic و /gemini). درخواستِ تو به زیرساختِ 1xAi می‌رسد و از همان‌جا — نه از سرورِ تو — برای سرویس‌دهنده دوباره ارسال می‌شود. یعنی IP و User-Agent تو هرگز به OpenAI، Anthropic، Google یا DeepSeek نمی‌رسد و ردِ پایی از «کاربرِ ایرانی» در سمتِ ارائه‌دهنده وجود ندارد.

فهرستِ کاملِ مدل‌ها و قیمتِ لحظه‌ایِ تومانیِ هرکدام در صفحهٔ مدل‌ها در دسترس است.

هیچ زیرساختی — داخلی یا خارجی — از اختلالِ شبکه مصون نیست؛ چیزی که فرق می‌کند مهندسیِ سمتِ کلاینت است. سه الگوی عملی که توصیه می‌کنیم:

1. ۱ · تلاشِ مجدد با backoff نمایی و jitter. خطاهای گذرای شبکه را با ۲–۳ تلاشِ مجدد و فاصلهٔ افزایشی جذب کن و برای هر درخواست timeout صریح بگذار تا اتصالِ معلق، منابعِ سرورت را نگیرد.
2. ۲ · فال‌بکِ بین‌ارائه‌دهنده‌ای با همان یک کلید. چون همهٔ مدل‌ها پشتِ یک آدرسِ پایه‌اند، اگر مدلی از یک ارائه‌دهنده خطا داد می‌توانی بدونِ کلید یا کلاینتِ جدید، همان درخواست را به مدلِ هم‌ردهٔ ارائه‌دهندهٔ دیگر بدهی:

import time, random
from openai import OpenAI

client = OpenAI(base_url="https://1xai.ir/v1", api_key="1xai-...")

# One key, three vendors: if a provider errors, fall through to the next.
MODELS = ["gpt-4o-mini", "claude-haiku-4-5", "gemini-2.5-flash"]

def ask(messages, retries=3):
    last_err = None
    for model in MODELS:
        for attempt in range(retries):
            try:
                return client.chat.completions.create(
                    model=model, messages=messages, timeout=30,
                )
            except Exception as e:
                last_err = e
                # exponential backoff + jitter
                time.sleep((2 ** attempt) + random.random())
    raise last_err

۳ · پایش با صفحهٔ وضعیت. وضعیتِ لحظه‌ایِ هر چهار ارائه‌دهنده به‌صورتِ عمومی در صفحهٔ /status منتشر می‌شود؛ قبل از باز کردنِ تیکت یا مقصر دانستنِ کدِ خودت، یک نگاه به آن‌جا بینداز و در سیستمِ مانیتورینگِ خودت هم همان را چک کن.

1. ۱ · در 1xai.ir ثبت‌نام کن — فقط ایمیل و گذرواژه.
2. ۲ · هدیهٔ ۱۰۰٬۰۰۰ تومانی را پس از ثبت‌نام با یک کلیک در داشبورد دریافت کن؛ برای شارژِ بیشتر، حداقل ۱۰۰٬۰۰۰ تومان از طریقِ زرین‌پال. جزئیات در صفحهٔ اعتبارِ رایگان.
3. ۳ · از داشبورد یک کلیدِ 1xai-* بساز و همان لحظه کپی‌اش کن.
4. ۴ · آدرسِ پایه را عوض کن و اولین درخواست را بفرست:

curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "سلام"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://1xai.ir/v1",  # the only change to your code
    api_key="1xai-...",             # minted in the dashboard
)

r = client.chat.completions.create(
    model="claude-haiku-4-5",  # or gpt-4o-mini, gemini-2.5-flash, ...
    messages=[{"role": "user", "content": "سلام!"}],
)
print(r.choices[0].message.content)

راهنمای کاملِ خرید و شارژ در خرید API هوش مصنوعی آمده است.