إنشاء مقاطع فيديو
تُرجع الإرسال HTTP 202 مع معرف وظيفة ShareAI ورابط الاستعلام.
في هذه الصفحة
https://api.shareai.now/api/v1/videosإنشاء مقاطع فيديو
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
- النطاق المطلوب
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);حقول الطلب#
| الحقل | النوع | مطلوب |
|---|---|---|
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}التحقق من حالة المهمة#
https://api.shareai.now/api/v1/videos/{id}قراءة إنشاء فيديو باستخدام بيانات الاعتماد الأصلية
- عنوان URL الأساسي
https://api.shareai.now- المصادقة
- مفتاح واجهة برمجة التطبيقات Bearer أو رمز وصول OAuth المعتمد
- النطاق المطلوب
inferenceormonetization_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 العشوائية للردود.
رابط إلى وحدات الفوترة