مستندات وقتی چیزی کار نمی‌کند

خطاها و محدودیت‌ها

معنی هر پیام خطا، علت رایج آن، و کاری که باید بکنید.

اگر درخواستی ناموفق برگشت، معمولاً یکی از چند مورد زیر است. پیام‌ها به زبان حساب شما برمی‌گردند: اگر در پنل کاربری از منوی زبان «فارسی» را برگزیده باشید فارسی، وگرنه انگلیسی. جدول زیر هر دو را آورده است.

پیام‌های رایج

پیام	یعنی چه	چه کنید
`Invalid token` یا «کلید API نامعتبر است»	کلید نادرست، حذف‌شده، ناقص یا منقضی است، یا اعتبار خود کلید تمام شده	کلید را دوباره از پنل کپی کنید و دقت کنید فاصله یا خط تازه همراهش نرفته باشد. در پنل کاربری، تاریخ انقضا و سقف اعتبار کلید را هم ببینید
`No available channel for model X …` یا «برای مدل X … هیچ کانالی در دسترس نیست»	نام مدل وجود ندارد یا در دسترس نیست	نام را با فهرست مدل‌ها بسنجید. رایج‌ترین علت، غلط تایپی در نام مدل است
`field messages is required`	ساختار درخواست ناقص است	آرایۀ `messages` را بفرستید. نمونه‌ها در آشنایی با API ها
`Insufficient user quota …` یا «سهمیۀ کاربر کافی نیست …»، و `Not enough quota to pre-consume …` یا «سهمیه برای پیش‌کسر این درخواست کافی نیست …»	موجودی حساب برای این درخواست کافی نیست	حساب را شارژ کنید. توضیح در کیف پول
`Your IP address is not on this token's allowlist` یا «نشانی IP شما در فهرست مجاز این کلید API نیست»	درخواست از نشانی‌ای آمده که در IP Whitelist این کلید نیست	از سروری بفرستید که در فهرست است، یا در پنل کاربری نشانی تازه را به فهرست همین کلید اضافه کنید
`This token has no access to model X` یا «این کلید API به مدل X دسترسی ندارد»	این کلید فقط به مدل‌های فهرست Model Limits خودش دسترسی دارد	مدل را به فهرست مجاز کلید اضافه کنید یا کلیدی به کار ببرید که به آن مدل دسترسی دارد
`The current group is at capacity …` یا «ظرفیت گروه فعلی پر است …»	فشار لحظه‌ای روی سرویس	چند لحظه بعد دوباره بفرستید

اگر جایی متن چینی دیدید، به ما خبر بدهید. همۀ پیام‌هایی که می‌شناسیم ترجمه شده‌اند و هر مورد تازه یک اشکال است، نه چیزی که لازم باشد شما با آن کنار بیایید.

خطاهای کلید

کلید با sk- شروع می‌شود و باید کامل کپی شود. سه اشتباه رایج:

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

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

خطاهای نام مدل

نام مدل باید دقیقاً همان چیزی باشد که در فهرست آمده. claude-sonnet-4-5 درست است؛ claude-sonnet-4.5 یا claude-3-5-sonnet نه.

نام‌های مدل‌های سرویس‌های دیگر اینجا کار نمی‌کنند، حتی اگر شبیه باشند. فهرست معتبر همیشه اینجاست:

curl https://dalai.ir/v1/models -H "Authorization: Bearer sk-YOUR-KEY"

پاسخ کند یا نیمه‌کاره

پاسخ دیر می‌آید: طبیعی است که مدل‌های بزرگ‌تر کندتر باشند. حالت جریانی (streaming) را روشن کنید تا متن از همان ثانیۀ اول دیده شود.
پاسخ نصفه می‌ماند: معمولاً max_tokens کم است. مقدارش را بالا ببرید.
قطع شدن در وسط: درخواست را دوباره بفرستید. اگر تکرار شد، با مدل دیگری امتحان کنید تا معلوم شود مشکل از مدل است یا از درخواست.

هنوز حل نشد

در پنل کاربری، بخش Usage Logs، ببینید درخواست اصلاً ثبت شده یا نه. اگر ثبت نشده، درخواست به ما نرسیده و مشکل در تنظیمات ابزار یا شبکه است.
همان درخواست را با curl امتحان کنید تا معلوم شود مشکل از ابزار است یا از درخواست. نمونه در آشنایی با API ها.
اگر ابزارتان Claude Code است و خطای No available channel for model می‌گیرید، تقریباً همیشه یعنی ANTHROPIC_MODEL تنظیم نشده و ابزار نام تاریخ‌دار مدل خودش را فرستاده است. تنظیم درست در کدنویسی با کمک DaLAi آمده است.
اگر باز هم حل نشد، به support@dalai.ir ایمیل بزنید. متن کامل خطا و شناسۀ درخواست (request id) را که در همان پیام آمده بفرستید؛ با آن شناسه می‌توانیم دقیقاً همان درخواست را در لاگ پیدا کنیم، و بدون آن معمولاً نمی‌شود.