الخدمات والأذونات
يعمل مفتاح API لحساب من أنشأه: يمكنه استدعاء الخدمات التي يُسمح لهذا الحساب باستخدامها، والوصول إلى موارد هذا الحساب فقط.
الخدمات التي يمكنك استدعاؤها
Section titled “الخدمات التي يمكنك استدعاؤها”| القدرة | هل يكلف ذلك رصيدًا؟ |
|---|---|
| التحميلات ومكتبة الملفات | التحميل والاستعلام مجانيان |
| ترجمة الملفات والتنزيلات | يتم احتساب تكلفة الترجمة؛ أما فحص الحالة والتنزيلات فهي مجانية |
| PDF وأدوات الصور | مجاني |
| عمليات المستند | extract و pdf_to_html مجانيان؛ يُحتسَب visual_extract حسب عدد الصفحات المعالجة فعليًا |
| ترجمة المقاطع الفورية والدفعة | يتم الفوترة حسب الاستخدام الفعلي |
| الصوت والفيديو والأصوات | يتم الفوترة حسب الاستخدام الفعلي |
| قوائم المصطلحات، المشاريع، العلامات، البحث والمشاركة | مجاني |
| سجلات الاستخدام والتوازن والتسوية | مجاني |
| SSE والاتصالات الفورية (وظائف ترجمة الملفات) | مجاني |
تسري أيضًا حالة خدمة الحساب وتنسيقات الملفات والحدود لكل طلب وحدود التزامن. عند تعذر توفر الخدمة، تُرجع الواجهة برمجة التطبيقات خطأً واضحًا؛ ولا تنتقل إلى خدمة أخرى تلقائيًا أبدًا.
مفاتيح واجهة برمجة التطبيقات مخصصة لاستدعاء نقاط النهاية الواردة في هذه الوثائق. لا يمكن للمفتاح تغيير عنوان البريد الإلكتروني أو كلمة المرور أو رقم الهاتف أو الملف الشخصي للمستخدم، كما أنه لا يتيح إنشاء مفاتيح واجهة برمجة التطبيقات أو تدويرها أو إلغائها؛ ولا يمكن تنفيذ الإجراءات التي تتطلب تأكيدًا عبر متصفح مسجل الدخول باستخدام المفتاح أيضًا. احرص على حماية مفتاحك كما تحافظ على كلمة مرور حسابك.
الموارد والتدقيق
Section titled “الموارد والتدقيق”- الموارد التي يتم إنشاؤها باستخدام مفتاح تابعة لحساب ذلك المفتاح.
- الرصيد ينتمي إلى الحساب؛ ويمكن لكل مفتاح أن يكون له ميزانيته الخاصة وإعدادات الترجمة المسموح بها.
- عند الاستعلام باستخدام مفتاح، تُرجع عمليات الائتمان وعمليات المستندات وقائمة الصوت فقط السجلات التي يبدأ المفتاح بها؛ بينما تُرجع قائمة الوظائف والاستخدام إجماليات الحساب.
الاستعلامات مجانية
Section titled “الاستعلامات مجانية”GET /api/v1/jobs/{job_id}GET /api/v1/artifacts?job_id={job_id}GET /api/v1/billing/credits/balanceGET /api/v1/billing/credits/operationsGET /api/v1/usage/summaryعند نفاد ميزانية المفتاح، لا يزال بإمكانك الاستعلام عن الوظائف والنتائج وسجلات الرصيد التي أنشأها ذلك المفتاح.