إنشاء واسترداد
تستخدم جميع المنتجات الثلاثة 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 أو تستخدم مقالًا متوسطًا غير نهائي.
تدفق مستقر للعملاء
- قراءة القدرات
- إرسال طلب صريح لإنشاء.
- قم بتنفيذ نفس الإبداع كل بضع ثوان.
- اقرأ النتائج بعد الاستعداد
- إذا توقفت، عرض الإجراءات المتاحة وانتظر الإجراء المطلوب للمستخدم.
- إذا فشلت، إظهار السبب الآمن والسماح للمستخدم مراجعة الطلب.
- إذا كان حالة الشبكة غير واضحة، والحصول على الإبداع الحالي قبل إنشاء آخر.
