نتائج إنشاء Felo

أنشئ عرضًا تقديميًا بشكل غير متزامن، ثم صدّر ملف PPTX. افصل بين مرحلتي الإنشاء والتصدير: فالمهمة المُنشأة ليست ملفًا مكتملًا بعد.

تستخدم جميع الأمثلة FELO_API_KEY من نظرة عامة. تستخدم الاستدعاءات رصيد المنصة، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

استخدم المعرفات المُعادة عند إنشاء المهمة. اضبط TASK_ID على task_id وPPT_ID على ppt_business_id؛ كما يعني {business_id} أيضًا ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

3. اقرأ نتائج الإنشاء

POST /api/v1/data/tasks/{task_id}/historical

هذه عملية POST، ولا تتطلب جسم JSON.

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/historical" \
  -H "Authorization: Bearer $FELO_API_KEY"

{
  "task_id":"example-task-id",
  "task_status":"COMPLETED",
  "history_data":{},
  "error_message":null
}

اقرأ task_status قبل استخدام history_data. قد يختلف حمولة السجل بحسب المهمة وقد تكون null. كل من ai_page_html وthread_short_id اختياريان. هذه الاستجابة ليست رابط تنزيل PPTX مضمونًا؛ استخدم التصدير بعد ذلك.

المدة والملكية والفوترة

• تنتهي صلاحية العروض التقديمية بعد سبعة أيام من الإنشاء. لا تؤدي الاستعلامات والتصديرات إلى تمديد هذه المدة. يصف expires_at الخاص بالعرض التقديمي وexpires_at الخاص برابط التنزيل الموقّع مددًا مختلفة.
• لا يمكن الوصول إلى المهام والعروض التقديمية إلا عبر حساب API المنشئ لها. قد يؤدي مورد مفقود أو غير متاح إلى 404؛ وقد يؤدي مورد منتهي الصلاحية أو محذوف إلى 410، أو 404 بعد التنظيف.
• يُفوتر الإنشاء لكل صفحة مُنشأة (ppt.generate). وبموجب تسعير الصفحات، يحجز الإنشاء سعر عشر صفحات، ثم يسوّي المخرجات الناجحة الفعلية ويُحرر الحجز غير المستخدم. يحتاج حسابك إلى رصيد متاح كافٍ للحجز حتى لو طلب النص صفحات أقل.
• للتصدير سعر طلب منفصل (ppt.export). استعلامات الحالة، واستعلامات النتائج، واستعلامات حالة التصدير، والحذف لا تنشئ رسومًا جديدة.
• بعد انتهاء المهلة، استعلم عن المهمة المحفوظة بدلًا من إنشاء عرض آخر. راجع الفوترة والأخطاء.