English مستندات برای برنامه‌نویسان

آشنایی با API ها

مسیرها، احراز هویت، حالت جریانی و نمونه‌های آماده برای هر دو گویش.

DaLAi یک درگاه سازگار با API استاندارد OpenAI است. اگر با آن API کار کرده‌اید، اینجا چیز تازه‌ای برای یاد گرفتن ندارید جز آدرس پایه.

احراز هویت

کلید را در سربرگ Authorization بفرستید:

Authorization: Bearer sk-YOUR-KEY

کلید را در آدرس صفحه یا در پارامتر query نفرستید. کلیدها در پنل کاربری، بخش API Keys، ساخته و حذف می‌شوند.

مسیرها

مسیرکار
https://dalai.ir/v1آدرس پایه؛ همین را در ابزارها وارد کنید
https://dalai.ir/v1/chat/completionsگفت‌وگو، گویش OpenAI
https://dalai.ir/v1/messagesگفت‌وگو، گویش Anthropic Messages
https://dalai.ir/v1/modelsفهرست زندۀ مدل‌ها

گویش OpenAI برای همۀ مدل‌ها کار می‌کند. گویش Anthropic Messages برای خانوادۀ claude-* در دسترس است.

نمونه، گویش OpenAI

curl https://dalai.ir/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-4-5",
    "messages": [
      {"role": "system", "content": "پاسخ‌ها را کوتاه بده."},
      {"role": "user",   "content": "سلام"}
    ]
  }'

با کتابخانۀ رسمی OpenAI در پایتون:

from openai import OpenAI

client = OpenAI(api_key="sk-YOUR-KEY", base_url="https://dalai.ir/v1")

r = client.chat.completions.create(
    model="claude-haiku-4-5",
    messages=[{"role": "user", "content": "سلام"}],
)
print(r.choices[0].message.content)

نمونه، گویش Anthropic

curl https://dalai.ir/v1/messages \
  -H "Authorization: Bearer sk-YOUR-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "سلام"}]
  }'

حالت جریانی

مقدار stream را true بگذارید تا پاسخ کلمه‌به‌کلمه برسد. بیشتر ابزارها این را پیش‌فرض روشن دارند.

-d '{"model": "claude-haiku-4-5", "stream": true, "messages": [...]}'

برای پاسخ‌های طولانی توصیه می‌شود: کاربر از همان ثانیۀ اول متن را می‌بیند.

فراخوانی ابزار

Tool calling در هر دو گویش پشتیبانی می‌شود و آزموده شده است. همان ساختاری که در مستندات OpenAI یا Anthropic آمده، بدون تغییر کار می‌کند.

محدودیت‌ها