Pixmind

مسار API المنشور

واجهة برمجة تطبيقات Seedance 2.5 Flash

أضف إنشاء الفيديو 480p/720p والمراجع متعددة الوسائط وسير عمل الفيديو المصدر إلى تطبيقك. أرسل طلبًا واحدًا، واحتفظ بمعرف المهمة الخاص به، واستفسر عن النتيجة من خلال واجهة برمجة التطبيقات الموحدة لـ PixMind.

محطة عمل للتحرير الداكن مع العديد من معاينات إطارات الفيديو للمهام الإبداعية غير المتزامنة
المفهوم الفوري الأصلي الذي تم إنشاؤه بواسطة الذكاء الاصطناعي، منفصل عن عينة فيديو Flash.
480p / 720p4-30 ثانية لكل مقطع10 صور · 5 فيديوهات · 5 مقاطع صوتيةالصوت الذي تم إنشاؤه تشغيل أو إيقاف تشغيله

إرسال طلب الفيديو

استخدم معرف النموذج الدقيق ومفتاح PixMind API الخاص بك. هذه هي نقطة النهاية PixMind ومخطط طلب CamelCase الخاص بها.

curl --request POST 'https://aihub-admin.aimix.pro/api-platform/v1/generations' \
  --header 'Authorization: Bearer YOUR_PIXMIND_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "seedance-2-5-flash",
  "prompt": "لقطة تتبع منخفضة متواصلة داخل دفيئة نباتية عند الفجر. طائر الكركي ذو التاج الأحمر يسير بجوار فانوس حجري وينشر جناحيه بلطف بجانب بركة ضحلة. تتتبع الكاميرا جانبيًا بسرعة ثابتة. ضباب ناعم، ضوء الشمس الدافئ، ريش واقعي، لا يوجد طيور أخرى ولا قطع.",
  "duration": 8,
  "resolution": "720p",
  "aspectRatio": "16:9",
  "generateAudio": false
}'

احتفظ بمعرف المهمة واستفسر عن النتيجة

تحتوي استجابة الإنشاء على معرف المهمة. استعلم عنه حتى اكتماله أو فشله، ثم احفظ عنوان URL للفيديو الذي تم إرجاعه. الرد المتأخر هو سبب للاستعلام عن المعرف الحالي، وليس تقديم وظيفة أخرى مدفوعة الأجر.

curl 'https://aihub-admin.aimix.pro/api-platform/v1/tasks/YOUR_TASK_ID' \
  --header 'Authorization: Bearer YOUR_PIXMIND_API_KEY'

أسعار رصيد PixMind

محفظة API مستقلة عن محفظة التطبيق. الأسعار هي 68 نقطة في الثانية بدقة 480p و140 بدقة 720p، أي 80% من أسعار التطبيق.

القراررصيد API / ثانيةرصيد التطبيق / ثانية
480p6885
720p140175

تُحجز تكلفة 30 ثانية عند اختيار المدة التلقائية. بعد الاكتمال تُحسب مدة الإخراج الفعلية مع التقريب إلى الثانية الأعلى. يستخدم تحرير الفيديو المدة التلقائية أيضًا.

أسئلة حول تكامل Flash API

ما هو معرف النموذج الذي يجب أن يرسله طلبي؟

أرسل seedance-2-5-flash. الاسم المستعار الأولي doubao-seedance-2-5-flash تم تطبيعه مع هذا النموذج. لا ترسل seedance-2.5-flash، ولا تستبدل طراز seedance-2.5 المنفصل.

ما هي نقطة النهاية ومخطط الطلب الذي يستخدمه PixMind؟

استخدم POST /api-platform/v1/generations مع النموذج والموجه وduration والدقة وaspectRatio. يقبل PixMind أيضًا حقول referenceImageUrls وreferenceVideoUrls وreferenceAudioUrls والحقول firstFrameUrl/lastFrameUrl. تتم ترجمة مخطط APIMart الأولي بواسطة المحول.

ما هي القرارات والمدد التي يمكنني طلبها؟

استخدم 480p أو 720p وعدد صحيح duration من 4 إلى 30 ثانية. اضبط duration على -1 للإخراج التلقائي duration. يتطلب التحرير -1 أو duration المحذوف ويتبع الفيديو المصدر. يتم رفض القرارات غير المدعومة قبل الإنشاء.

ما هي الحدود المرجعية؟

الحد الأقصى للصور المجمعة هو 10، مع ما يصل إلى 5 مقاطع فيديو و5 مقاطع صوتية. تتراوح مدة كل فيديو أو مقطع صوتي من 2 إلى 30 ثانية؛ لا يمكن أن يتجاوز الإجمالي 30 ثانية لكل نوع وسائط. يجب أن تتراوح مدة تحرير مقاطع الفيديو المصدر من 4 إلى 30 ثانية. استخدم عناوين URL للوسائط العامة أو مراجع الأصول المعتمدة.

كيف يجب أن أقدم الإطارات والتحرير والإرشاد؟

استخدم firstFrameUrl وlastFrameUrl بشكل اختياري للعمل الموجه بالإطار. اضبط الوضع لتحرير الفيديو المصدر أو توسيعه وتوفيره لعمليات سير العمل هذه. تتطلب طلبات الإطار فقط والتحرير والتوسيع تكيف aspectRatio. حقول المسودة غير مدعومة.

كيف يتم حساب أرصدة API؟

السعر هو 68 نقطة في الثانية بدقة 480p و140 بدقة 720p. ثماني ثوانٍ تكلف 544 أو 1120 نقطة. تحجز المدة التلقائية 30 ثانية، ثم تُحسب مدة الإخراج الفعلية مع التقريب إلى الثانية الأعلى. محفظة API وسجلها مستقلان عن التطبيق.

متى تكون النتيجة جاهزة للتحميل؟

استمر في الاستعلام عن معرف المهمة الأصلي أثناء انتظاره أو معالجته. الإكمال يجعل عنوان URL للفيديو متاحًا. يمكن أن ينتظر Flash لفترة وجيزة بيانات استخدام المورد بعد العرض. إذا كانت قيمة returnLastFrame صحيحة، فإن الاستجابة المكتملة تعرض أيضًا lastFrameUrl المحفوظة.

هل يجب علي إعادة محاولة الإنشاء بعد انتهاء المهلة؟

استعلم عن معرف المهمة المحفوظة أولاً. يمكن أن تعني مهلة الإنشاء أن المورد قد قبل المهمة؛ قد يؤدي الإرسال تلقائيًا مرة أخرى إلى إنشاء عمل مكرر. إذا لم يتم إرجاع أي معرف قابل للاستعلام، قم بتسوية سجل المورد قبل إعادة الإرسال. وظائف Flash المقدمة لا تدعم الإلغاء.

ماذا يحدث للاعتمادات عندما يفشل التوليد؟

المدخلات المرفوضة لا تبدأ في التوليد. يؤدي فشل التوليد المؤكد إلى إرجاع الرسوم الثابتة الأصلية أو تحرير حجز duration التلقائي. تؤدي أخطاء الاستقصاء أو التخزين إلى إبقاء المهمة الأصلية قيد التسوية بدلاً من إصدار استرداد بينما قد يستمر تشغيلها.