ShareAI Platform Docs

إنشاء مقاطع فيديو

تُرجع الإرسال HTTP 202 مع معرف وظيفة ShareAI ورابط الاستعلام.

عرض كـ Markdown
في هذه الصفحة
POST https://api.shareai.now/api/v1/videos

إنشاء مقاطع فيديو

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
النطاق المطلوب
inference or monetization_gateway

تُرجع الإرساليات HTTP 202 مع معرف مهمة ShareAI ورابط استعلام. أرسل Idempotency-Key رأسًا ثابتًا لإعادة المحاولة لنفس الطلب. يتم رفض إعادة استخدام المفتاح مع إدخال مختلف. استعلم GET /api/v1/videos/{id} باستخدام نفس بيانات الاعتماد الأصلية. تشمل الحالات: في قائمة الانتظار، قيد الانتظار، قيد التنفيذ، في مرحلة الإنهاء، مكتمل، فشل ويتطلب مراجعة. تحتاج نتيجة "يتطلب مراجعة" إلى تسوية من الفريق؛ الاستعلام لا يبدأ جيلًا آخر أبدًا.

قبل أن تبدأ#

المعنى والحدود.

إرسال طلب#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

حقول الطلب#

الحقلالنوعمطلوب
model سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.استعلام ذو صلة غير فارغ.
prompt سلسلة نصيةمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.مطالبة توليد غير فارغة، بحد أقصى 256 KiB من نص UTF-8.
durationعدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية.مدة الفيديو المطلوبة اختياريًا بالثواني، من 1 إلى 600، مع قيود إضافية حسب النموذج المختار. تحدد المدد الفعلية التي يتم إرجاعها الفوترة بناءً على المدة.
resolutionمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.محدد الدقة المدعوم من النموذج، بحد أقصى 100 حرف؛ يجب أن يتطابق مع نوع التعرفة المنشورة.
aspect_ratioمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.محدد نسبة العرض إلى الارتفاع المدعوم من النموذج، بحد أقصى 100 حرف.
sizeمعرف النموذج العام المفعل بالضبط. يجب أن يعلن عن هذه العملية وأن يكون مسموحًا بها بواسطة بيانات الاعتماد الخاصة بك.حجم الإخراج المدعوم من النموذج، بحد أقصى 100 حرف، على سبيل المثال 1024×1024. ليس كل نموذج يدعم هذا الخيار.
generate_audioمنطقياختيار مسار صوت الفيديو اختياري. يتطلب دعم النموذج وتوافق التعرفة.
seedعدد النتائج الاختياري من 1 إلى عدد المستندات. تشير المؤشرات المرجعة إلى مصفوفة المستندات الأصلية.البذرة المدعومة اختياريًا من النموذج. الفيديو يتطلب عددًا صحيحًا غير سالب؛ تعتمد القابلية للتكرار على المنفذ.
frame_imagesمصفوفةبحد أقصى جزئين من image_url، كل منهما مع نوع الإطار first_frame أو last_frame، بدون تكرار. لا تجمع بين frame_images وinput_references.
input_referencesمصفوفةبحد أقصى 16 جزءًا من image_url مع تعيين image_url.url إلى رابط HTTPS أو رابط بيانات صورة مدعوم. يتطلب دعم النموذج.
providerتفضيلات توجيه المزود الاختيارية. استخدم provider.only للعلامات المقبولة للمزود، وليس بادئة في معرف النموذج. لا تزال قيود الحساب والبيانات الاعتمادية سارية.النجاح يعيد HTTP 200 مع JSON. قدم استعلامًا و1–1000 مستند. كل مستند هو نص،.
allow_temporary_retentionمنطقيفيديو فقط. السماح الصريح بالقيمة true يتيح الاحتفاظ المؤقت بنتيجة المنبع على المسارات التي تتطلب ذلك. الإغفال/false يجعل تلك المسارات غير متاحة. يتعارض مع provider.zdr:true؛ العمليات الأخرى تحتفظ بـ ZDR الإلزامي.

قراءة النتيجة#

النجاح يُرجع HTTP 202 مع JSON. تُرجع الإرساليات HTTP 202 مع معرف مهمة ShareAI ورابط استعلام. أرسل Idempotency-Key رأسًا ثابتًا لإعادة المحاولة لنفس الطلب. يتم رفض إعادة استخدام المفتاح مع إدخال مختلف. استعلم GET /api/v1/videos/{id} باستخدام نفس بيانات الاعتماد الأصلية. تشمل الحالات: في قائمة الانتظار، قيد الانتظار، قيد التنفيذ، في مرحلة الإنهاء، مكتمل، فشل ويتطلب مراجعة. تحتاج نتيجة "يتطلب مراجعة" إلى تسوية من الفريق؛ الاستعلام لا يبدأ جيلًا آخر أبدًا.

وحدات الفوترة#

تعلن مسارات الفيديو عن وحدات الفوترة الخاصة بها. يتم تسوية المسار لكل ثانية باستخدام المدة المقاسة لكل ملف تم إرجاعه، وليس المدة المطلوبة أو تكلفة USD المنبع. يجب أن تكون المدة المطلوبة بين 1 و600 ثانية ومدعومة من النموذج. يمكن أن يغطي احتجاز ائتماني محافظ ما يصل إلى أربعة مخرجات.

يتم نشر الأسعار بعملة EUR AI credits للنموذج المحدد، المزود، الوحدات والمتغيرات. يتم فرض الرسوم فقط على الأبعاد في التعريفة النشطة. يحتفظ التقدير بالاعتمادات قبل التنفيذ؛ تستخدم الرسوم النهائية الاستخدام المقاس. يمكن أن تعتمد الأسعار على الدقة، تنسيق الإخراج أو نطاق الاستخدام. تحقق من Console Usage للحصول على الخصم النهائي من ShareAI. لا يتم تحويل حقول التكلفة الأولية والوسائط إلى عدد رموز مُخترع.

التسعير والاستخدام#

لتوجيه تكلفة الشبكة المعتمدة أو.

الوصول والأخطاء#

استخدم inference لزيادة معتمدة من Builder وشروط الفوترة المقبولة. الوصول بالهوية فقط لا يصرح بالإنفاق. التحقق، تفويض النموذج، الاعتمادات غير الكافية، حدود المعدل وفشل التنفيذ تعيد هيكلًا monetization_gateway . بعد انتهاء المهلة أو تقديم غير مؤكد، تحقق من الاستخدام أو مهمة الفيديو قبل إنشاء طلب آخر قد يكون مدفوعًا. error. آخر تحديث نوفمبر 3, 2026.

الاحتفاظ المؤقت بالفيديو#

تحتاج بعض مسارات الفيديو إلى الاحتفاظ المؤقت بالمنبع حتى يمكن استرداد النتيجة المولدة. تتطلب قبولك allow_temporary_retention:true الصريح على طلب الفيديو هذا. يؤدي الإغفال إلى جعل تلك المسارات غير متاحة. ينطبق هذا الاستثناء على الفيديو فقط ولا يسمح أبدًا بتدريب النماذج أو الاحتفاظ بها للعمليات الأخرى. لا يمكن إضعاف سياسة ZDR الصريحة بصمت.

JSON

{"allow_temporary_retention": true}

التحقق من حالة المهمة#

GET https://api.shareai.now/api/v1/videos/{id}

قراءة إنشاء فيديو باستخدام بيانات الاعتماد الأصلية

عنوان URL الأساسي
https://api.shareai.now
المصادقة
مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
النطاق المطلوب
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

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

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

تنزيل النتيجة#

عند الاكتمال، يحتوي كل إدخال بيانات على رابط محتوى ShareAI. قم بجلب GET /api/v1/videos/{id}/content?index=0 باستخدام نفس بيانات الاعتماد الأصلية. يدعم نقطة النهاية نطاق HTTP بايت واحد فقط. لا يتم إرجاع روابط المزود، التذاكر الخاصة أو بيانات اعتماد المزود أبدًا. لا يؤدي الاستعلام والتنزيل إلى إنشاء طلب استدلال ثانٍ أو رسوم إدخال بوابة تحقيق الدخل. تعني المهمة المكتملة أن التسوية مؤكدة قبل أن يصبح الملف قابلاً للتنزيل.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

يجب أن تحتوي frame_images الاختيارية على أجزاء image_url مع first_frame أو last_frame. استخدم صور الإطارات أو الصور المرجعية في طلب واحد، وليس كلاهما. قد تكون مدة النماذج ودقتها ونسب العرض إلى الارتفاع أكثر تقييدًا من حدود الأمان الخاصة بـ API. لا يتم دعم Webhooks أو عناوين URL العشوائية للردود.

رابط إلى وحدات الفوترة

مستندات منصة ShareAI
جميع المستندات

البحث حسب العنوان أو المحتوى.

اسأل عن هذه الصفحة

اختر مساعدًا لاستكشاف هذه الصفحة. يمكنك أيضًا نسخ الصفحة ولصقها في محادثتك.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI