مراجعة/OpenAPI/إنشاء واسترداد

إنشاء واسترداد

تحميل المصادر، وخلق المحتوى، واسترداد التقدم، والائتمان، والخروج.

إنشاء واسترداد

تستخدم جميع المنتجات الثلاثة API واحد، لذلك تشارك مقاطع الفيديو والصور ونتائج التطبيقات نفس القائمة والتفاصيل وتدفق العمل الناتج.

تحميل الملفات المصدر

جميع المنتجات تقبل input_file_ids. تحميل الملف أولاً:

curl -s "https://api.kpainter.ai/openapi/v1/files" \  -H "Authorization: Bearer $KPAINTER_API_KEY" \  -F "file=@./handbook.pdf"

مثال الإجابة :

{  "file_id": "file_xxx",  "name": "handbook.pdf",  "mime_type": "application/pdf",  "size_bytes": 248391}

استخدم الملف_ID الذي تم إرجاعه فقط داخل الإبداعات المملوكة لنفس الحساب.

إنشاء

POST /creations

المجالات المشتركة :

الميدان مطلوب معنى
النوع نعم فيديو أو صورة أو تطبيق
عاجل نعم ما الذي يجب إنشاؤه
تعليمات لا متطلبات إضافية
إدخال_file_ids لا ID المصدر المرفوع سابقا
ماكس - الاعتماد لا الحد الأقصى للمؤهلات المسموح بها لهذا المهمة
فيديو / صورة / تطبيق نعم بالضبط واحد الإعدادات موضوع مطابقة النوع

مثال :

{  "type": "app",  "prompt": "Build a safety quiz with immediate feedback from the handbook",  "input_file_ids": ["file_xxx"],  "app": {    "language": "en"  }}

قائمة و احصل على

GET /creations?page=1&page_size=20GET /creations?type=video&page=1&page_size=20GET /creations/{id}

مجالات التفاصيل المفيدة:

الميدان معنى
الوضع التخطيط أو الإنتاج أو الاستراحة أو الاستعداد أو الفشل
التقدم_pct التقدم المتناغم من 0 إلى 100
تقييم_تقييم_ثانية الحضور فقط عندما تكون موثوقة
التقديرات_الائتمان التقديرات الحالية لهذا المهمة
الائتمان الحقيقي الائتمان الصافي لمهمة ناجحة
has_usable_تسليم إذا كان هناك نتيجة قابلة للاستخدام بالفعل
متوفرة_العمل الإجراءات التي هي آمنة حاليا للاتصال
مراجعة آمنة توضيح الفيديو الخروج عندما يكون متاحا
النتيجة_code رمز النتيجة الآمن للمستخدم

الفشل العادي يغيب عن الأوراق المالية الحقيقية. إيتا غير موثوقة يتم تجاهلها بدلاً من التخمين.

اقرأ النتائج

GET /creations/{id}/outputs

عرض فقط العودة الخروج. لا تضع عنوان URL أو تستخدم مقالًا متوسطًا غير نهائي.

تدفق مستقر للعملاء

  1. قراءة القدرات
  2. إرسال طلب صريح لإنشاء.
  3. قم بتنفيذ نفس الإبداع كل بضع ثوان.
  4. اقرأ النتائج بعد الاستعداد
  5. إذا توقفت، عرض الإجراءات المتاحة وانتظر الإجراء المطلوب للمستخدم.
  6. إذا فشلت، إظهار السبب الآمن والسماح للمستخدم مراجعة الطلب.
  7. إذا كان حالة الشبكة غير واضحة، والحصول على الإبداع الحالي قبل إنشاء آخر.