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

مستندات 1xAi و API

هر موضوع صفحهٔ خودش را دارد: شروع سریع، احراز هویت، محدودیت نرخ، خطاها، صورت‌حساب، مدل‌ها و مسیرهای API. از راهنمای کاربر شروع کن یا مستقیم سراغ صفحه‌ای برو که لازم داری.

آدرس پایهhttps://1xai.ir/v1

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

  • سازگار با OpenAI
  • بدون وی‌پی‌ان
  • صورت‌حساب تومانی
  • ۱٬۰۰۰ درخواست در دقیقه
curl · اولین درخواست
curl https://1xai.ir/v1/chat/completions \
  -H "Authorization: Bearer 1xai-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "سلام"}]
  }'

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

راهنمای کاربر · ۱

شروع سریع در ۵ دقیقه

از ثبت‌نام تا دیدن مصرف در داشبورد، در شش گام.

  1. گام ۱

    ثبت‌نام و تأیید

    از صفحهٔ ثبت‌نام با ایمیل یا شمارهٔ موبایل حساب بساز و آن را تأیید کن.

  2. گام ۲

    تکمیل پروفایل هویتی

    در /onboarding نام کامل، کد ملی و شمارهٔ موبایلت را ثبت کن. تا این پروفایل کامل نشده، داشبورد کلید صادر نمی‌کند و شارژ ممکن نیست.

  3. گام ۳

    گردونهٔ هدیه یا شارژ

    حساب تازه یک بار گردونهٔ هدیه را می‌چرخاند. برای ادامه، از صفحهٔ شارژ کیف پول را شارژ کن.

  4. گام ۴

    ساخت کلید API

    در کلیدهای API یک کلید 1xai-* صادر و همان لحظه کپی کن؛ دوباره نشان داده نمی‌شود.

  5. گام ۵

    یک تماس با curl

    یک درخواست به /v1/chat/completions بفرست و مدل را روی gpt-5.5، claude-sonnet-5 یا gemini-3.5-flash بگذار.

  6. گام ۶

    دیدن مصرف

    در داشبورد همان تماس را با هزینهٔ تومانی، توکن‌ها و زمانش می‌بینی.

POST /v1/chat/completions

اولین تماس

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

نسخهٔ کامل، با نمونهٔ Python و Node: شروع سریع API.

راهنمای کاربر · ۲

شروع به کار

استفاده از 1xAi به نصب چیزی نیاز ندارد: حساب می‌سازی، کلید API می‌گیری و آدرس پایهٔ کلاینتت را عوض می‌کنی. اگر نمی‌خواهی کد بنویسی، از آزمایشگاه یک پیام بفرست تا اولین پاسخ را بگیری.

راهنمای کاربر · ۳

آشنایی با داشبورد

موجودی فعلی
مبلغی که با هر تماس موفق کم می‌شود.
کلیدهای API
فهرست کلیدها، با پیشوند، نام و آخرین استفاده.
گزارش مصرف
تماس‌های اخیر، با مدل، توکن و هزینهٔ تومانی هر تماس.

راهنمای کاربر · ۴

راهنمای داشبورد

خلاصهٔ موجودی
موجودی فعلی، مصرف یک روز گذشته، شمار تماس‌های موفق و ناموفق.
نمودارها
تماس‌های روزانه، توکن‌ها و سهم هر سازنده، به وقت تهران.
جست‌وجو در گزارش
فیلتر روی متن، مدل، سازنده، وضعیت و بازهٔ زمانی، در سمت سرور.
صفحهٔ هر کلید
نمودار، آخرین تماس‌ها، مدل‌های پرمصرف، سقف خرج و دکمهٔ ابطال همان کلید.
تنظیمات و امنیت
تغییر رمز، تأیید دومرحله‌ای و فهرست نشست‌های فعال.

راهنمای کاربر · ۵

شارژ موجودی

در صفحهٔ شارژ مبلغ و روش پرداخت را انتخاب می‌کنی: درگاه زرین‌پال، درگاه دیجی‌پی و کارت‌به‌کارت با ثبت رسید. هر شارژ از ۱٬۰۰۰ تومان تا ۲۵٬۰۰۰٬۰۰۰ تومان است و ۱۰٪ مالیات بر ارزش افزوده روی مبلغ اضافه می‌شود. پرداخت با درگاه بلافاصله به کیف پول می‌نشیند؛ کارت‌به‌کارت پس از بررسی رسید تأیید می‌شود.

جزئیات قیمت، کارمزد و برگشت وجه: صورت‌حساب و قیمت‌گذاری.

راهنمای کاربر · ۶

آزمایشگاه

آزمایشگاه برای فرستادن یک پیام به مدل بدون نوشتن کد است: مدل را انتخاب می‌کنی، پیامت را می‌نویسی و پاسخ، همراه با هزینهٔ تومانی همان تماس، نمایش داده می‌شود.

راهنمای کاربر · ۷

انتخاب مدل مناسب

با یک کلید و یک آدرس به مدل‌های ۱۰ سازنده می‌رسی و نام مدل تعیین می‌کند درخواست به کدام سازنده برود. مدل‌های کوچک (mini، flash، haiku) سبک و ارزان‌اند و برای بیشتر کارهای روزمره کافی هستند؛ مدل‌های پرچم‌دار برای کارهای پیچیده‌تر مناسب‌ترند. فهرست زنده با قیمت تومانی در صفحهٔ مدل‌ها است و جدول مسیریابی در مستند مدل‌ها.

راهنمای کاربر · ۸

اتصال ابزارها به 1xAi

راهنمای کاربر · ۹

پرسش‌های پرتکرار

آیا برای استفاده از 1xAi نیاز به VPN دارم؟

نه. API و سایت 1xAi بدون فیلترشکن از ایران در دسترس‌اند، و هزینه به تومان و با کارت بانکی ایرانی پرداخت می‌شود.

آیا متن درخواست‌های من ذخیره می‌شود؟

درخواست تو به سازندهٔ همان مدلی که انتخاب کرده‌ای فرستاده می‌شود. کنار هر ردیف گزارش مصرف، ابتدای متن درخواست و پاسخ (تا ۶۴ کیلوبایت) و اگر بلندتر بود ۱۶ کیلوبایت پایانی آن نگه داشته می‌شود تا در گزارش مصرف خودت ببینی‌اش. این متن پس از ۳۰ روز پاک می‌شود. عددها (مدل، توکن، هزینه، وضعیت و زمان) برای حسابداری می‌مانند. نشانی IP و User-Agent تو به سازندهٔ مدل فرستاده نمی‌شود.

چطور بفهمم هر تماس چقدر هزینه داشت؟

هر تماس یک ردیف در گزارش مصرف داشبورد دارد، با مدل، توکن‌ها و مبلغ تومانی کم‌شده. همین ردیف‌ها را با همان کلید از GET /v1/usage هم می‌توانی بخوانی، یا یک بازه را به‌صورت فایل CSV بگیری. پاسخ غیراستریم هر تماس هم مبلغش را در هدر X-1xai-Cost-Toman دارد، و شناسهٔ هر تماس در هدر X-Request-Id است.

آیا کلید 1xAi با SDKهای OpenAI کار می‌کند؟

بله. در کتابخانه‌های Python‏، Node‏، Go، ‎.NET و هر کلاینت دیگری کافی است base_url را روی https://1xai.ir/v1 بگذاری و کلید 1xAi را به جای کلید OpenAI بدهی. همان کلاینت و همان کلید به مدل‌های Claude و Gemini هم می‌رسد.

آیا 1xAi به مدل‌های Claude دسترسی دارد؟

بله. مدل‌های Anthropic مانند claude-sonnet-5 و claude-haiku-4-5 روی همان مسیر /v1/chat/completions در دسترس‌اند: هر نام مدلی که با claude- شروع شود به Anthropic فرستاده می‌شود. برای کش پرامپت و فکر گسترده، مسیر نیتیو /anthropic/v1/messages هم هست.

آیا می‌توانم از مدل‌های Gemini گوگل استفاده کنم؟

بله. مدل‌های Google مانند gemini-3.1-pro-preview و gemini-3.5-flash از همان API در دسترس‌اند: هر نام مدلی که با gemini- یا gemma- شروع شود به Google فرستاده می‌شود، بدون تغییر کد یا کلید.

هر کلید چند درخواست در دقیقه می‌تواند بفرستد؟

به‌طور پیش‌فرض ۱٬۰۰۰ درخواست در دقیقه برای هر کلید، که می‌شود همه را یک‌جا فرستاد. بیشتر از آن پاسخ 429 با هدر Retry-After می‌گیری و هزینه‌ای ندارد. سقف بالاتر را پشتیبانی برای حساب تنظیم می‌کند.
بخش دوم

مرجع API: هر موضوع، یک صفحه

همهٔ مسیرها روی همین آدرس پایه، با هدر Authorization: Bearer 1xai-*:

آدرس پایهhttps://1xai.ir/v1

شروع

مفاهیم پایه

مسیرهای API

حساب، کلید و تیم

امکانات تازه

برای ابزارها و مدل‌های زبانی: مشخصات OpenAPI، و نسخهٔ متنی هر صفحه با افزودن /md به ابتدای مسیر آن (مثل /md/docs/rate-limits).

کلید بساز و اولین درخواست را همین حالا بزن.