الرصيد والاستخدام
تُسوى الخدمات القابلة للفوترة عبر رصيد الحساب. تُقدَّم المبالغ بوحدة الميليكريديت (millicredits)؛ و1000 ميليكريديت تعادل 1 كريديت. يجب أن تكون المبالغ التي ترسلها في الطلبات أعدادًا صحيحة؛ أما المبالغ في الأرصدة والسجلات فيجوز أن تحتوي على منزلة عشرية واحدة (0.1 ميليكريديت). القيمة credit_precision في الاستجابات هي 4، أي بحد أقصى 4 منازل عشرية بعد التحويل إلى كريديتات.
تحقق من الرصيد
Section titled “تحقق من الرصيد”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"الحقول الأساسية:
| الحقل | المعنى |
|---|---|
available | الرصيد بالميليكريديت متاح الآن بعد سداد الدين؛ ويكون سالبًا عند وجود دين |
debt | الدين بالميليكريديت: هو الجزء من التكلفة الفعلية للوظائف المكتملة الذي تجاوز الرصيد. وتُستخدم الاعتمادات التي تصل لاحقًا (مثل عمليات الشحن الإضافي، والمنح اليومية، ورموز الاسترداد، والمبالغ المستردة، وما إلى ذلك) أولاً لسداد هذا الدين. |
spent | إجمالي الميليكريديتس المُسَدَّدة |
expired | الميليكريديتس التي انتهت صلاحيتها أو تم سحبها |
today_charged | تم تسوية الميليكريديتس اليوم |
lots | الكثير من الاعتمادات سارية المفعول وتواريخ انتهاء صلاحيتها |
حزم الائتمان
Section titled “حزم الائتمان”GET /api/v1/billing/credits/plansنقطة نهاية عامة لا تتطلب تسجيل الدخول وتُرجع الحزم المعروضة للبيع (purchase_plans)، مرتبة حسب رمز الخطة. معروضة للبيع الآن:
| رمز الخطة | الاعتمادات | السعر | مكافأة |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4 (موصى به) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- يُحتسَب “البونص” بناءً على سعر 10,000 رصيد مقابل ¥29.90 وهو الحقل
bonus_percent؛ أما الحزمة الموصى بها فلها الحقلrecommended: true. ولا يظهر أي من الحقلين إذا لم يتم تعيينه. price_fen(بالفِن، أي 1/100 يوان) هو الوحدة الرسمية للسعر، وtotal_millicredits(ميليكريدت) هي وحدة النقاط. لا تنتهي صلاحية النقاط المشتراة؛ ويمكن إعادة شراء الحزم، وتصل جميعها دفعة واحدة في كل مرة.
دورة شحن كاملة
Section titled “دورة شحن كاملة”- يتم فحص الرصيد مقارنةً بالعتبة قبل بدء المهمة : يجب أن يكون الرصيد (بعد الخصم) أعلى من عتبة المهمة، على سبيل المثال “عدد الصفحات × 2 رصيد” لترجمة PDF، وطول النص المصدر للملفات الأخرى (بحد أدنى 2 رصيد)، وبالنسبة للصوت والفيديو والكلام تُحسب التكلفة بناءً على المدة أو عدد الأحرف التي قاسها الخادم (الأسعار بـ الصوت والفيديو والأصوات ). ومع وجود مفتاح API يحتوي على ميزانية، يجب أيضًا أن تكون الميزانية المتبقية للمفتاح أعلى من العتبة. وإلا فإن الاستجابة تكون
402(تنتهي مهمة ترجمة الملف بالفشل معquota_exceeded=true، وتنتهي مهمة الوسائط معerror_code=insufficient_credits) ولا يتم تحصيل أي رسوم. إن بدء المهمة لا يغيّر الرصيد. - يتم تحصيل رسوم الاستخدام الفعلي عند اكتماله : تُحتسب رسوم ترجمة الملفات (بما في ذلك الصور)، والنصوص المنسقة بالدفع الدفعي، وعمليات المستندات، والصوت، والفيديو، والكلام كاملةً بناءً على الاستخدام الفعلي عند الانتهاء. يساهم ميزانية مفتاح API فقط في عملية التحقق قبل البدء ولا يقلل أبداً من الرسوم المفروضة على مهمة مكتملة؛ وإذا أدى ذلك إلى تجاوز الميزانية المستخدمة للمفتاح لحدّها الأقصى، فلن يتمكن المفتاح من بدء مهام جديدة حتى يتم رفع الحدّ. لا تُفرض رسوم على المهام التي تفشل أو تُلغى.
- يمكن أن يصبح الرصيد سالبًا : يتم تسجيل الجزء من التكلفة الفعلية الذي يتجاوز الرصيد كدين، ويظهر الرصيد على أنه سالب؛ وتُسدد الديون أولاً عند وصول الأرصدة الدائنة لاحقًا. لا يمكن بدء وظائف جديدة بينما يكون الرصيد سالبًا؛ يلزم إعادة التمويل.
لا يقدّم العملاء أبدًا طلبًا بعنوان “كم يجب أن يكون المبلغ المستحق؟”؛ بل يقوم الخادم بحساب المبلغ النهائي بناءً على ما تم تسليمه.
العمليات والسجلات
Section titled “العمليات والسجلات”GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}يحتوي السجل على معرّف العملية، والحالة، وأساس الفوترة، والمبالغ المفوترة والمُعادة. عند تحديد مفتاح واجهة برمجة التطبيقات، تشمل العمليات فقط تلك التي بدأها ذلك المفتاح.
الاستخدام
Section titled “الاستخدام”GET /api/v1/usage?limit=50GET /api/v1/usage/summaryتُعيد نقاط نهاية الاستخدام عدد ملفات الحساب، وعدد الأحرف، والرموز، ووقت المعالجة.
الاستعلامات مجانية
Section titled “الاستعلامات مجانية”لا تُحتسب رسوم مقابل فحص الرصيد، وحالة الوظيفة، والاستخدام، وسجلات التسوية، وقوائم النتائج، وعناوين التنزيل.