English مستندات پیش از خرید، اینجا را ببینید

آشنایی با ابزارها

کدام ابزارها با DaLAi کار می‌کنند، در پنج دسته، و هرکدام را دقیقاً کجا تنظیم کنید.

DaLAi با API استاندارد OpenAI سازگار است و گویش Anthropic Messages را هم پاسخ می‌دهد. هر ابزاری که یکی از این دو را بفهمد و بگذارد آدرس پایه و کلید را خودتان وارد کنید، با DaLAi کار می‌کند.

در بیشتر ابزارها تنها دو چیز را تغییر می‌دهید: آدرس پایه روی https://dalai.ir/v1 و کلید روی کلیدی که در پنل ساخته‌اید. ابزارهایی که با گویش Anthropic کار می‌کنند آدرس را بدون /v1 می‌گیرند؛ این استثنا کنار همان ابزار آمده است.

ابزارها در پنج دسته آمده‌اند:

DaLAi گویش Responses را پشتیبانی نمی‌کند. اگر ابزاری میان چند گویش انتخاب می‌دهد، OpenAI Compatible یا Chat Completions را بردارید، نه گزینه‌ای که نام Responses دارد.

ابزارهای برنامه‌نویسی

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

ابزارجای تنظیم
Claude Code
عامل		سه متغیر محیطی، نه تنظیمات برنامه؛ آدرس بدون /v1. شرح پایین‌تر
opencode
عامل		یک ارائه‌دهندۀ سازگار با OpenAI در فایل opencode.json. شرح کامل در کدنویسی با کمک DaLAi
Cline
عامل		API Provider را روی OpenAI Compatible بگذارید، سپس Base URL و کلید
Kilo Code
عامل		Settings ← Providers ← Custom provider؛ در Provider API گزینۀ OpenAI Compatible و در Base URL مقدار https://dalai.ir/v1
Aider
دستیار		aider --openai-api-base https://dalai.ir/v1 --openai-api-key sk-...
Continue
دستیار		در config.yaml: provider: openai و apiBase: https://dalai.ir/v1
Zed
دستیار و عامل		Settings ← AI ← LLM Providers ← Add Provider، نوع OpenAI و API URL برابر https://dalai.ir/v1

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

Claude Code

Claude Code با گویش Anthropic کار می‌کند و تنظیمش با بقیۀ این صفحه فرق دارد: سه متغیر محیطی می‌گیرد، و برخلاف بقیه، /v1 را نباید به آدرس اضافه کنید. دستورهای آمادۀ ویندوز و macOS و Linux در کدنویسی با کمک DaLAi آمده است.

اولین پیام هر نشست Claude Code بسیار گران‌تر از یک پیام معمولی است، چون ابزار پیش از کار شما یک دستور سیستمی بزرگ می‌فرستد. با موجودی نزدیک به صفر شروع نکنید. عدد اندازه‌گیری‌شده در همان صفحه آمده است.

ابزارهای عامل‌محور

عامل (agent) کاری چندمرحله‌ای را خودش پیش می‌برد: برنامه می‌ریزد، ابزار صدا می‌زند، نتیجه را می‌خواند و قدم بعد را برمی‌دارد. DaLAi مدل را فراهم می‌کند و فراخوانی ابزار (tool calling) در هر دو گویش پشتیبانی می‌شود. خود ابزارها و سرورهای MCP روی دستگاه یا سرور شما اجرا می‌شوند. عامل‌های کدنویسی در دستۀ قبل آمده‌اند.

عامل‌های آماده

ابزارکاربرد و جای تنظیم
Gooseعامل همه‌منظوره برای دسکتاپ و خط فرمان، با افزونه‌های MCP. Settings ← Models ← Configure providers ← Add Provider؛ Provider Type را OpenAI Compatible و API URL را https://dalai.ir/v1 بگذارید

چارچوب‌های ساخت عامل

نمونه با OpenAI Agents SDK، که بدون این تنظیم گویش Responses را صدا می‌زند:

from openai import AsyncOpenAI
from agents import Agent, Runner, OpenAIChatCompletionsModel, set_tracing_disabled

set_tracing_disabled(True)
client = AsyncOpenAI(base_url="https://dalai.ir/v1", api_key="sk-YOUR-KEY")
model = OpenAIChatCompletionsModel(model="claude-sonnet-4-5", openai_client=client)

agent = Agent(name="assistant", instructions="Answer briefly.", model=model)
print(Runner.run_sync(agent, "سلام").final_output)

خط set_tracing_disabled(True) گزارش ردگیری را خاموش می‌کند تا کتابخانه برای فرستادن آن به سرور OpenAI تلاش نکند.

کتابخانه‌های برنامه‌نویسی

اگر با یکی از این کتابخانه‌ها خطا گرفتید، ببینید درخواست به /v1/chat/completions می‌رود یا نه. بعضی کتابخانه‌ها به‌طور پیش‌فرض مسیر دیگری را صدا می‌زنند: در LangChain مقدار use_responses_api=False را بگذارید، در Pydantic AI از OpenAIChatModel استفاده کنید، در Vercel AI SDK از بستۀ @ai-sdk/openai-compatible، و در LlamaIndex مقدار is_chat_model=True را.

خودکارسازی و گردش کار

این ابزارها مدل را در یک فرایند می‌گذارند: رویدادی مثل یک ایمیل تازه، یک فرم یا یک پیام، مدل را صدا می‌زند و نتیجه به سامانۀ بعدی می‌رود. هر چهار ابزار را می‌توانید روی سرور خودتان نصب کنید.

ابزارکاربرد و جای تنظیم
n8nخودکارسازی گردش کار، با گرۀ AI Agent. یک اعتبارنامۀ OpenAI با Base URL برابر https://dalai.ir/v1، سپس گرۀ OpenAI Chat Model با Use Responses API خاموش
Difyساخت برنامه، عامل و گردش کار با رابط بصری. Integrations ← Model Provider، افزونۀ OpenAI-API-compatible با API Base URL برابر https://dalai.ir/v1
Flowiseساخت زنجیره و عامل با کشیدن و رها کردن. گرۀ OpenAI Custom Model؛ نام مدل را بنویسید و در Additional Parameters مقدار Base Path را https://dalai.ir/v1 بگذارید
Langflowساخت جریان و عامل به‌صورت بصری. Settings ← Model Providers ← OpenAI Compatible، با Base URL و کلید

دو تنظیم که اگر از قلم بیفتد، عامل کار نمی‌کند. در n8n گزینۀ Use Responses API در گرۀ تازه به‌طور پیش‌فرض روشن است و باید خاموشش کنید؛ از گرۀ جداگانۀ OpenAI با کار Message a Model هم استفاده نکنید. در Dify برای هر مدل، Function Call Type را روی Tool Call بگذارید و Model context size را به اندازۀ واقعی مدل برسانید.

ابزارهای سازمانی

پلتفرم‌های چندکاربره‌ای که سازمان روی سرور خودش نصب می‌کند. کلید DaLAi فقط روی سرور می‌ماند و کارکنان با حساب سازمانی خودشان وارد می‌شوند. این‌که کدام را برای چه کاری بردارید و چطور راهش بیندازید، در راهنمای استفادۀ سازمانی آمده است.

ابزارکاربرد و جای تنظیم
Open WebUIدرگاه گفت‌وگوی داخلی با ورود یکپارچه (OIDC و LDAP)، گروه‌های کاربری و دسترسی به مدل برای هر گروه. مدیر: Settings ← Admin ← Connections، یک اتصال OpenAI با https://dalai.ir/v1
LibreChatدرگاه گفت‌وگوی چندکاربره با ورود یکپارچه و سقف اعتبار برای هر کاربر. یک custom endpoint در librechat.yaml با baseURL برابر https://dalai.ir/v1
AnythingLLMگفت‌وگو با اسناد سازمان در فضاهای کاری جدا، با نقش‌های کاربری در نسخۀ Docker. Settings ← AI Providers ← LLM، ارائه‌دهندۀ Generic OpenAI با Base URL برابر https://dalai.ir/v1
LiteLLM Proxyدرگاه داخلی سازمان: کلید و بودجۀ جدا برای هر تیم، پشت یک کلید DaLAi. در config.yaml با پیشوند openai/ برای نام مدل و api_base برابر https://dalai.ir/v1؛ نمونه در راهنمای استفادۀ سازمانی

در Open WebUI مدل‌های یک اتصال تازه تا وقتی مدیر آن‌ها را عمومی نکند یا به گروهی ندهد، فقط برای خود مدیر دیده می‌شوند. قابلیت گفت‌وگو با اسناد به یک مدل embedding نیاز دارد که DaLAi فعلاً عرضه نمی‌کند؛ از مدل embedding محلی خود این پلتفرم‌ها استفاده کنید.

برنامه‌های گفت‌وگوی شخصی

ابزارکاربرد و جای تنظیم
Cherry Studioدسکتاپ؛ گفت‌وگو، دستیارهای آماده و عامل‌ها. Settings ← Model Provider ← Add Provider، شرح کامل پایین‌تر
Janدسکتاپ؛ ساده و روی دستگاه خودتان. Settings ← Model Providers ← Add Provider، قالب OpenAI-compatible و Base URL برابر https://dalai.ir/v1
Chatboxدسکتاپ و موبایل. Settings ← Model Provider ← Add، حالت OpenAI API Compatible و API Host برابر https://dalai.ir/v1

در Jan یک ارائه‌دهندۀ تازه بسازید و آدرس ارائه‌دهندۀ آمادۀ OpenAI را عوض نکنید؛ آن یکی گویش Responses را صدا می‌زند.

Cherry Studio

Cherry Studio به گفتۀ سازندگانش «استودیوی بهره‌وری هوش مصنوعی با گفت‌وگوی هوشمند، عامل‌های خودکار و بیش از ۳۰۰ دستیار، و دسترسی یکپارچه به پیشرفته‌ترین مدل‌های زبانی» است. روی ویندوز، macOS و Linux اجرا می‌شود و برنامه روی دستگاه خودتان است. این مراحل برای نسخۀ 2.1.4 نوشته شده‌اند.

  1. برنامه را از سایت Cherry Studio بگیرید و اجرا کنید. اگر در اولین اجرا صفحۀ انتخاب ارائه‌دهنده باز شد، Set up later را بزنید.
  2. با چرخ‌دندۀ پایین نوار کناری به Settings بروید، Model Provider را باز کنید و پایین فهرست، Add Provider را بزنید.
  3. در Provider Name بنویسید DaLAi و در API Key کلید خودتان را بگذارید.
  4. در بخش Endpoint settings، در هر دو فیلد OpenAI و Anthropic فقط https://dalai.ir را بنویسید، بدون /v1. برنامه خودش آن را اضافه می‌کند و مسیر کامل را زیر هر فیلد نشان می‌دهد.
  5. Add را بزنید. فهرست مدل‌های قابل استفاده با کلید شما باز می‌شود. مدل‌هایی را که می‌خواهید علامت بزنید و Add selected models را بزنید. برنامه هر مدل را آزمایش می‌کند و ارائه‌دهنده را خودش روشن می‌کند.
  6. در صفحۀ گفت‌وگو، از بالای صفحه مدل را از گروه DaLAi انتخاب کنید.

اگر بعدها مدلی به فهرست مدل‌ها اضافه شد، در همان صفحۀ ارائه‌دهنده دکمۀ Sync models را بزنید. اگر کلید را با محدودیت مدل ساخته‌اید، فقط همان مدل‌ها در فهرست می‌آیند.

فعلاً کار نمی‌کند

برنامه‌هایی که پیشنهاد نمی‌کنیم

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

اگر ابزار شما در این فهرست نیست

احتمالاً باز هم کار می‌کند. دنبال این عبارت‌ها در تنظیمات بگردید:

اگر چنین فیلدی وجود داشت، آدرس پایه و کلید را بگذارید و نام مدل را از فهرست مدل‌ها بردارید. جزئیات مسیرها در آشنایی با API ها.