راهنمای اتصال به API

Open WebUI با 1ai؛ رابط چت روی سرور خودتان با GPT، Claude و Gemini

Open WebUI یک رابط چت متن‌باز است که روی سرور خودتان نصب می‌شود و با هر API سازگار با Chat Completions کار می‌کند. با وان ای آی (1ai) کافی است یک اتصال OpenAI با آدرس `https://1ai.ir/v1` و یک کلید بسازید تا مدل‌ها از `GET /v1/models` به‌طور خودکار در انتخابگر ظاهر شوند. هزینه از اعتباری کم می‌شود که با پرداخت ریالی می‌خرید و برای کلید سقف مصرف می‌گذارید. در این راهنما راه‌اندازی با Docker، تنظیم دقیق اتصال، استفاده‌ی تیمی و اتصال بردار متن، تصویر و گفتار را می‌بینید.

ساخت کلید APIمدل‌هایی که در Open WebUI ظاهر می‌شوند
Open WebUI با 1ai روی سرور شخصی؛ صفحه‌ی Connections با آدرس https://1ai.ir/v1 و فهرست مدل‌ها

چرا با 1ai

روی سرور خودتان

رابط و تاریخچه‌ی گفتگوها روی سرور شما می‌ماند و فقط متن هر درخواست برای پاسخ به 1ai فرستاده می‌شود.

فهرست خودکار مدل‌ها

Open WebUI مدل‌ها را از `/v1/models` می‌خواند؛ با فهرست Model IDs فقط مدل‌هایی را نشان دهید که می‌خواهید.

کاربران و دسترسی‌ها در Open WebUI

مدیر Open WebUI کاربران را تأیید می‌کند و تعیین می‌کند چه کسی به کدام مدل دسترسی داشته باشد.

پرداخت ریالی

مصرف همه‌ی کاربران از اعتبار حساب 1ai کم می‌شود که با پرداخت ریالی شارژ می‌شود؛ کارت ارزی لازم نیست.

سقف مصرف برای کلید

برای کلید Open WebUI سقف ماهانه، مدل‌های مجاز و سقف درخواست در دقیقه بگذارید تا هزینه‌ی تیم قابل پیش‌بینی بماند.

در چند قدم

  1. ۱

    Open WebUI را اجرا کنید

    با Docker و دستور نمونه‌ی همین صفحه Open WebUI را بالا بیاورید و در مرورگر پورت 3000 را باز کنید.

  2. ۲

    حساب مدیر بسازید

    اولین حسابی که ثبت‌نام می‌کند مدیر می‌شود. این کار را خودتان و پیش از معرفی آدرس به دیگران انجام دهید.

  3. ۳

    اتصال 1ai را اضافه کنید

    در Settings › Admin › Connections یک اتصال OpenAI با URL برابر `https://1ai.ir/v1` و کلید `sk-1ai-…` بسازید و Verify Connection را بزنید.

  4. ۴

    مدل را انتخاب کنید

    در صفحه‌ی چت از انتخابگر بالا یک مدل، مثلاً `anthropic/claude-sonnet-5.5`، را برگزینید و گفتگو را شروع کنید.

مدل‌هایی که در Open WebUI ظاهر می‌شوند

همه‌ی مدل‌ها

GPT-6.1 Sol

اوپن‌ای‌آی
گفتگو

پرچم‌دار اوپن‌ای‌آی برای کارهای دقیق، تحلیلی و چندمرحله‌ای

۱٫۵ اعتبار / ۱۰۰۰ توکن خروجی
API

Claude Sonnet 5.5

آنتروپیک
گفتگو

نویسندگی روان و برنامه‌نویسی دقیق

۱٫۵ اعتبار / ۱۰۰۰ توکن خروجی
API

Gemini 3.8 Flash

گوگل
گفتگو

سریع، چندوجهی و با حافظه‌ی متنی بسیار بلند

۰٫۵۶۲۵ اعتبار / ۱۰۰۰ توکن خروجی
API

Claude Haiku 5.5

آنتروپیک
گفتگو

سریع‌ترین کلود؛ در سهمیه‌ی رایگان روزانه

۰٫۰۷۵ اعتبار / ۱۰۰۰ توکن خروجی
رایگان روزانهAPI

Gemini 3.5 Flash Lite

گوگل
گفتگو

سبک و ارزان؛ در سهمیه‌ی رایگان روزانه

۰٫۳۷۵ اعتبار / ۱۰۰۰ توکن خروجی
رایگان روزانهAPI

DeepSeek V4.1 Flash

دیپ‌سیک
گفتگو

سریع و بسیار ارزان؛ در سهمیه‌ی رایگان روزانه

۰٫۰۹ اعتبار / ۱۰۰۰ توکن خروجی
رایگان روزانهAPI

نمونه پرامپت‌ها

پرامپت را کپی کنید، در 1ai بگذارید و جزئیات خودتان را جایگزین کنید.

خلاصه‌ی سند

Summarise the attached document in Persian in five bullet points and list every date and deadline it mentions.

فایل را با دکمه‌ی پیوست کنار کادر پیام اضافه کنید.

مقایسه‌ی دو مدل

Explain the difference between TCP and UDP for a junior developer, with one real-world example for each.

در انتخابگر مدل، با + دو مدل را کنار هم بگذارید تا پاسخ‌ها را مقایسه کنید.

پرامپت سیستم برای دستیار داخلی

You are the internal assistant of [نام شرکت]. Answer in Persian and be concise. If the answer is not in the provided documents, say «نمی‌دانم» instead of guessing.

این را در System Prompt یک مدل سفارشی در Workspace بگذارید.

ایمیل اداری

یک ایمیل رسمی و کوتاه به [نام گیرنده] بنویس و مؤدبانه درخواست کن جلسه‌ی [موضوع جلسه] به [تاریخ پیشنهادی] منتقل شود.

کوئری SQL

Write a MySQL query on orders(id, customer_id, total, created_at) that returns the 10 customers with the highest total purchases in the last 30 days, with their order count.

Open WebUI چیست و چه زمانی به کار می‌آید؟

Open WebUI رابط وب چت با تاریخچه، پیوست فایل، مدل‌های سفارشی با پرامپت سیستم، مدیریت کاربران و افزونه‌های خودش است. خودش مدلی ندارد و به API وصل می‌شود.

اگر فقط برای خودتان چت می‌خواهید، چت فارسی 1ai روی وب و اپ اندروید آماده است و نصب لازم ندارد. Open WebUI وقتی به کار می‌آید که بخواهید رابط چت را روی سرور خودتان، برای همکارانتان و با تنظیمات خودتان داشته باشید.

پیش‌نیازها:

  • یک سرور یا رایانه با Docker که به https://1ai.ir دسترسی دارد
  • حساب 1ai با اعتبار و یک کلید sk-1ai-…
  • آشنایی با صفحه‌ی توسعه‌دهندگان و شناسه‌ی مدل‌ها

راه‌اندازی Open WebUI با Docker و 1ai

bash
docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY=your-secret-key \
  -e OPENAI_API_BASE_URL=https://1ai.ir/v1 \
  -e OPENAI_API_KEY=sk-1ai-... \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main
  • WEBUI_SECRET_KEY را یک بار با openssl rand -hex 32 بسازید و ثابت نگه دارید؛ وگرنه با هر ساخت دوباره‌ی کانتینر همه از حساب خارج می‌شوند.
  • حجم open-webui گفتگوها، کاربران و تنظیمات را نگه می‌دارد؛ هرگز بدون آن اجرا نکنید.
  • اگر حجم دانلود مهم است، به جای :main از :slim استفاده کنید.
  • OPENAI_API_BASE_URL و OPENAI_API_KEY فقط در اولین اجرا خوانده می‌شوند و بعد در پایگاه داده ذخیره می‌شوند. برای تغییرهای بعدی از پنل مدیریت استفاده کنید.

افزودن اتصال 1ai در Settings › Admin › Connections

اگر متغیرها را در Docker نگذاشتید یا اتصال دوم می‌خواهید:

  1. به Settings › Admin › Connections بروید و فهرست Manage OpenAI API Connections را پیدا کنید.
  2. روی + Add Connection بزنید.
  3. URL را https://1ai.ir/v1 و API Key را کلید sk-1ai-… بگذارید.
  4. در Model IDs فقط مدل‌های چتی را که می‌خواهید اضافه کنید، مثل anthropic/claude-sonnet-5.5، openai/gpt-6.1-sol و deepseek/deepseek-v4.1-flash. اگر خالی بماند، همه‌ی مدل‌های کلید از جمله مدل‌های تصویر و گفتار در فهرست چت می‌آیند.
  5. اگر چند ارائه‌دهنده دارید، یک Prefix ID مثل 1ai بگذارید تا نام‌ها قاطی نشوند.
  6. Verify Connection را بزنید و بعد Save.

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

استفاده‌ی تیمی؛ بردار متن، تصویر و گفتار

  • با DEFAULT_USER_ROLE=pending هر ثبت‌نام تازه تا تأیید مدیر منتظر می‌ماند. دسترسی هر گروه به مدل‌ها را از پنل مدیریت Open WebUI تعیین کنید.
  • برای کارهای جانبی مثل ساختن عنوان گفتگو، TASK_MODEL_EXTERNAL را روی یک مدل ارزان مثل deepseek/deepseek-v4.1-flash بگذارید.
  • بردار متن، تصویر و گفتار هم از همان API می‌آیند:
bash
RAG_EMBEDDING_ENGINE=openai
RAG_OPENAI_API_BASE_URL=https://1ai.ir/v1
RAG_OPENAI_API_KEY=sk-1ai-...
RAG_EMBEDDING_MODEL=openai/text-embedding-3-small

ENABLE_IMAGE_GENERATION=true
IMAGE_GENERATION_ENGINE=openai
IMAGES_OPENAI_API_BASE_URL=https://1ai.ir/v1
IMAGES_OPENAI_API_KEY=sk-1ai-...
IMAGE_GENERATION_MODEL=openai/gpt-image-2

AUDIO_TTS_ENGINE=openai
AUDIO_TTS_OPENAI_API_BASE_URL=https://1ai.ir/v1
AUDIO_TTS_OPENAI_API_KEY=sk-1ai-...
AUDIO_TTS_MODEL=openai/tts-1

AUDIO_STT_ENGINE=openai
AUDIO_STT_OPENAI_API_BASE_URL=https://1ai.ir/v1
AUDIO_STT_OPENAI_API_KEY=sk-1ai-...
AUDIO_STT_MODEL=openai/whisper-1

ویرایش تصویر در Open WebUI به مسیر images/edits نیاز دارد که API 1ai فعلاً ندارد؛ فقط ساخت تصویر را روشن کنید.

رفع خطا و کنترل هزینه

  • Verify Connection خطای 401 می‌دهد: کلید اشتباه، باطل یا منقضی است.
  • هیچ مدلی دیده نمی‌شود: اتصال خاموش است، URL بدون /v1 نوشته شده یا Model IDs شناسه‌ی اشتباه دارد.
  • 404 model_not_found: شناسه را دستی و بدون پیشوند سازنده نوشته‌اید.
  • 402 در گفتگو: اعتبار یا سقف ماهانه‌ی کلید تمام شده است.
  • 429 rate_limit_exceeded: سقف درخواست در دقیقه‌ی حساب پر شده؛ وقتی کاربران زیادند، این سقف زودتر می‌رسد.
  • فهرست مدل‌ها دیر بار می‌شود: AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST را کمی بیشتر کنید.

همه‌ی کاربران از یک کلید و یک کیف اعتبار مصرف می‌کنند؛ پس برای آن کلید سقف ماهانه و مدل‌های مجاز بگذارید و مصرف را در پنل توسعه‌دهنده دنبال کنید. اگر چند تیم جدا دارید، برای هر کدام یک نمونه‌ی Open WebUI با کلید جدا راه بیندازید. جزئیات در راهنمای کلیدها و کنترل هزینه.

ابزارهای آماده

خلاصه‌ساز متن

خلاصه‌ی دقیق مقاله، گزارش، جزوه یا صورت‌جلسه

نامه‌ی اداری و ایمیل رسمی

نامه و ایمیل کاری مؤدبانه، کامل و آماده‌ی ارسال

ساخت کوئری SQL

درخواست فارسی، کوئری درست و توضیح‌داده‌شده

دستیارهای مرتبط

دستیار پژوهش

جستجو در وب، جمع‌بندی منابع و نوشتن گزارش مستند

  • «آخرین پیشرفت‌های باتری‌های حالت جامد را با ذکر منبع جمع‌بندی کن»
  • «برای پایان‌نامه‌ام درباره‌ی یادگیری الکترونیکی، مرور ادبیات کوتاهی بنویس»
جست‌وجوی وب

سوالات متداول

Open WebUI را انتخاب کنم یا چت خود 1ai را؟

برای استفاده‌ی شخصی، چت 1ai روی وب و اندروید آماده است و حافظه، جست‌وجوی وب و ساخت تصویر در گفتگو را دارد. Open WebUI برای وقتی است که بخواهید رابط را روی سرور خودتان نگه دارید، کاربرانتان را خودتان مدیریت کنید یا آن را به ابزارهای داخلی سازمان وصل کنید.

تاریخچه‌ی گفتگوها کجا ذخیره می‌شود؟

در پایگاه داده‌ی خود Open WebUI روی سرور شما، داخل حجم Docker به نام open-webui. متن هر پیام برای ساختن پاسخ به 1ai و از آن‌جا به سازنده‌ی مدل انتخابی فرستاده می‌شود.

هر کاربر Open WebUI کلید جداگانه می‌خواهد؟

خیر. کلید را مدیر در اتصال وارد می‌کند و همه‌ی کاربران از همان کلید استفاده می‌کنند. در پنل 1ai مصرف به تفکیک کلید دیده می‌شود، نه به تفکیک کاربر Open WebUI.

بدون Docker هم می‌شود Open WebUI را نصب کرد؟

بله. مستندات Open WebUI روش‌های Python، Kubernetes و نسخه‌ی دسکتاپ را هم دارد. تنظیم اتصال 1ai در همه یکسان است: یک اتصال OpenAI با آدرس https://1ai.ir/v1 و کلید شما.

سرور Open WebUI در ایران است؛ به 1ai وصل می‌شود؟

بله. https://1ai.ir/v1 از سرورهای داخل ایران در دسترس است و پرداخت هم ریالی است. فقط برای دانلود ایمیج Docker از ghcr.io باید سرور به آن دسترسی داشته باشد.

فراخوانی ابزار و افزونه‌های Open WebUI با 1ai کار می‌کند؟

بله، برای مدل‌هایی که از ابزار پشتیبانی می‌کنند. Open WebUI پارامترهای استاندارد tools و tool_choice را می‌فرستد و 1ai آن‌ها را در Chat Completions پشتیبانی می‌کند. اگر مدلی ابزار ندارد، ابزارها را برای همان مدل خاموش کنید.

مطالب مرتبط

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL
توسعه‌دهندگان

استفاده از API سازگار با OpenAI در 1ai: راهنمای عملی با Python، Node.js و cURL

چطور پروژه‌ای را که با کتابخانه‌ی OpenAI نوشته شده، فقط با تغییر آدرس پایه و کلید به 1ai وصل کنید؛ با نمونه کد Python، Node.js و cURL، استریم، فهرست مدل‌ها و مدیریت خطا.

۴ دقیقه مطالعه
کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه
توسعه‌دهندگان

کلید API در 1ai: امنیت، محدودیت‌ها و کنترل هزینه

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

۴ دقیقه مطالعه
حریم خصوصی و امنیت داده در 1ai: چه چیزی ذخیره می‌شود و چه کنترلی دارید
راهنمای 1ai

حریم خصوصی و امنیت داده در 1ai: چه چیزی ذخیره می‌شود و چه کنترلی دارید

شفاف و بی‌اغراق: داده‌های شما در 1ai کجا می‌رود، چطور محافظت می‌شود، چه کسی به آن دسترسی دارد و با حافظه، اشتراک‌گذاری، نشست‌ها و حذف حساب چه کنترلی بر آن دارید.

۴ دقیقه مطالعه
مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی
مفاهیم هوش مصنوعی

مدل زبانی بزرگ (LLM) چیست؟ راهنمای کاربردی برای فارسی

LLM موتور بسیاری از دستیارهای هوش مصنوعی است. با مثال‌های ساده، سازوکار آن، تفاوت مدل‌های باز و بسته و روش انتخاب مدل مناسب برای متن و کارهای فارسی را بشناسید.

۱۱ دقیقه مطالعه

صفحه‌های مرتبط

همه‌ی امکانات

OpenAI SDK

کتابخانه‌ی رسمی openai را در Python و Node.js با تغییر آدرس پایه به 1ai وصل کنید و چت، فراخوانی ابزار، بردار متن، تصویر و صدا را از یک کلید بگیرید.

اتصال n8n

در n8n یک اعتبارنامه‌ی OpenAI با آدرس 1ai بسازید و در گردش‌کارهای خودکار، از AI Agent تا ربات تلگرام، با GPT، Claude، Gemini و DeepSeek کار کنید.

چت با هوش مصنوعی

گفتگوی فارسی با مدل‌های مطرح دنیا در یک محیط راست‌به‌چپ، با تاریخچه، حافظه، جست‌وجوی وب و اعتبار رایگان روزانه.

Open WebUI با 1ai؛ رابط چت روی سرور خودتان با GPT، Claude و Gemini

Open WebUI را روی سرور خودتان بالا بیاورید، یک اتصال OpenAI با آدرس 1ai بسازید و برای کاربرانتان رابط چت با GPT، Claude، Gemini و DeepSeek داشته باشید.

ساخت کلید API