DANA API REFERENCE
API · v1خطاها و بازیابی
خطا را اصلاح کنید؛ درخواست تولید را بی‌دلیل دوباره نفرستید.
فهرست مستندات ۱۴ بخش
آدرس پایهٔ همین محیط
https://api.danaai.ai/v1خطاهای SDK در ساختار error با message، type، code و param هستند. اطلاعات محرمانهٔ پروایدر و کلیدها برگردانده نمی‌شوند.
اگر استریم شروع شده باشد، خطا یک رویداد terminal است نه وضعیت HTTP تازه. خروجی ناقص را موفق تلقی نکنید.
برای درخواست‌های GET یا کار idempotent، Retry-After و محدودیت نرخ را رعایت کنید. برای Responses/Chat، retry خودکار خاموش باشد؛ قطع ارتباط ممکن است پس از پذیرش تولید رخ داده باشد.
پارامترها و محدودیت‌ها
- 400 / 422
- ورودی، پارامتر، رسانه یا عملیات ناسازگار؛ همان درخواست را بدون اصلاح تکرار نکنید.
- 401 / 403
- کلید نامعتبر/منقضی/لغوشده یا دسترسی حساب/مدل ناکافی.
- 404
- مدل، کار یا فایل متعلق به این محدوده پیدا نشد.
- 408
- مهلت انتقال فایل تمام شده؛ آماده‌شدن فایل را فرض نکنید.
- 409
- تعارض idempotency، پذیرش هم‌زمان یا خروجی هنوز آماده نیست؛ code را بخوانید.
- 413
- اندازهٔ بدنه یا فایل بیشتر از سقف مجاز است.
- 429
- سقف نرخ یا هم‌زمانی؛ Retry-After را رعایت کنید.
- 502 / 504
- خطای بالادستی/خروجی یا پایان انتظار HTTP؛ ابتدا وضعیت کار و لاگ را بررسی کنید.
شکل خطای SDK؛ نمونهٔ غیرواقعی
{ "error": { "message": "The requested parameter is not supported.", "type": "invalid_request_error", "code": "invalid_request", "param": null }}پاسخ و خطاها
ساختار پاسخ خطا: error شامل message، type، code و param. کد HTTP را همراه code بخوانید؛ در استریم، رویداد خطا را نیز بررسی کنید.
ساختار خطا و راهنمای بازیابینمونهها از پکیج رسمی openai یا HTTP استاندارد استفاده می‌کنند، نه «SDK جدید دانا». کپی‌کردن کد هیچ درخواست پولی ارسال نمی‌کند. کلید را فقط در سرور نگه دارید.