الانتقال إلى المحتوى الرئيسي
عند حدوث خطأ، تُعيد Venice API رمز حالة HTTP ورسالة وصفية. تتضمن بعض الأخطاء أيضًا حقولًا إضافية، مثل حالة الاسترداد، أو النماذج المقترحة لإعادة المحاولة، أو تفاصيل التحقق، أو معرّفات الطلب.

صيغة استجابة الخطأ

تُعيد معظم الأخطاء حقل error مع رسالة قابلة للقراءة من قِبَل الإنسان:
تتضمن بعض endpoints حقولًا إضافية خاصة بالـ endpoint. على سبيل المثال، يمكن أن تتضمن أخطاء التحكم بمحتوى الفيديو ما إذا تم استرداد الاعتمادات:
قد تتضمن أخطاء التحقق حقلي details و issues مع معلومات التحقق على مستوى الحقل:
قد تُعيد بعض endpoints المتوافقة مع OpenAI كائنات أخطاء بأسلوب OpenAI لحالات محددة، مثل أخطاء طول السياق:

بيانات الاعتماد المفقودة

يُرجع الطلب الذي لا يتضمن بيانات اعتماد 402 Payment Required، وليس 401. تقبل كل المسارات المدفوعة أيضًا مصادقة المحفظة عبر x402، لذا تكون الاستجابة تحدّيًا للدفع: فهي تتضمن ترويسة PAYMENT-REQUIRED ونصًا يصف طريقتي المصادقة.
إذا كنت تقصد استخدام مفتاح API، فتحقق من تعيين ترويسة Authorization: Bearer. يُرجع المفتاح الموجود ولكن غير الصالح 401.

أخطاء تنسيق الطلب

تصدر هذه الأخطاء عند قراءة جسم الطلب، قبل تشغيل أي تحقق خاص بنقطة النهاية. تُرجع قيمة Content-Type الخاطئة 400، وليس 415. تتضمن استجابات 413 الخاصة بحدّ الحجم أيضًا الحقل code:

رموز الأخطاء

أخطاء أخرى

الجدول أعلاه ليس شاملًا. تُرجَع بعض الأخطاء دون رمز مدرج، وقد تختلف الرسائل حسب النموذج ونقطة النهاية، لذا اعتمد في التفريع على حالة HTTP بدلًا من نص الرسالة. أخطاء قد تواجهها وليست في الجدول: