Video
PixVerse V6
ولّد مقاطع PixVerse V6 مدتها 1–15 ثانية من نص أو صورة أو إطارين أو صور مرجعية أو مقطع سابق، بدقة من 360p إلى 1080p، تُحتسب لكل ثانية.
PixVerse V6 هو نموذج الفيديو من PixVerse. يغطي معرّف نموذج واحد خمسة أوضاع: من نص إلى فيديو، ومن صورة إلى فيديو، وانتقال بين إطار أول وأخير، ومراجع متعددة الصور، وتمديد مقطع سبق أن أنشأته. يتحدّد الوضع بالحقول التي ترسلها. مدة المقاطع 1–15 ثانية بدقة 360p أو 540p أو 720p أو 1080p، مع صوت أصلي اختياري. أرسل الطلب، واحتفظ بمعرّف المهمة المُعاد، واقرأ الفيديو المكتمل من المهمة. تُرسل الصور كروابط URL.
معرّفات النماذج
| معرّف النموذج | المدخلات | الدقات | الطول |
|---|---|---|---|
pixverse-v6 | نص، صورة واحدة، إطار أول + أخير، 1–7 صور مرجعية، مهمة pixverse-v6 مكتملة | 360p، 540p، 720p، 1080p | 1–15 ثانية |
راجع صفحة النموذج للاطلاع على الأسعار الحالية. للقطة واحدة بتفاصيل أعلى من نص أو صورة واحدة، راجع PixVerse V6 Max.
مثال سريع
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "540p",
"duration": 5,
"size": "16:9"
}'نقطة النهاية
POST https://api.seedrouter.ai/v1/videos/generations| الترويسة | القيمة |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
الاستجابة مهمة ({"id": "task_...", "status": "processing"}) لا الفيديو المكتمل. استعلم GET /v1/tasks/{task_id} للحصول على النتيجة. واحتفظ بمفاتيح API في شفرة تعمل على الخادم.
المعاملات
| الحقل | النوع | القيمة الافتراضية | ملاحظات |
|---|---|---|---|
model | string | مطلوب | pixverse-v6 |
prompt | string | مطلوب | حتى 5,000 حرف. مطلوب في كل وضع. |
resolution | enum | 540p | 360p أو 540p أو 720p أو 1080p. |
duration | integer | 5 | 1–15 ثانية. يقبل الانتقال بين الإطار الأول والأخير 5 أو 8 فقط. |
size | enum | 16:9 | 16:9 أو 4:3 أو 1:1 أو 3:4 أو 9:16 أو 2:3 أو 3:2 أو 21:9. يُستخدم للتحويل من نص إلى فيديو والمراجع متعددة الصور؛ أما الأوضاع الأخرى فتتبع صورها. |
audio | boolean | false | توليد صوت أصلي. يُحتسب بسعر الصوت. |
seed | integer | لا يوجد | 0–2147483647. يعطي الطلب نفسه والبذرة نفسها نتائج متشابهة. |
negative_prompt | string | لا يوجد | ما تريد استبعاده من المقطع. حتى 2,048 حرفًا. |
watermark | boolean | false | إضافة علامة مائية. |
motion_mode | enum | normal | لا يُدعم سوى normal. |
generate_multi_clip_switch | boolean | false | توليد مقاطع متعددة. للتحويل من نص أو صورة إلى فيديو فقط. |
image_urls | قائمة روابط URL | لا يوجد | من صورة إلى فيديو. تُستخدم الصورة الأولى. |
first_frame_image | URL | لا يوجد | الانتقال: الإطار الأول. أرسله مع last_frame_image. |
last_frame_image | URL | لا يوجد | الانتقال: الإطار الأخير. أرسله مع first_frame_image. |
img_references | قائمة روابط URL | لا يوجد | مراجع متعددة الصور: 1–7 صور. |
extend_from_task_id | string | لا يوجد | التمديد: معرّف إحدى مهام pixverse-v6 المكتملة الخاصة بك. |
المخطط صارم: تُرفض الحقول غير المعروفة بدلًا من تجاهلها. وcallback_url غير متاح؛ استعلم عن المهمة بدلًا منه.
الأوضاع
الحقول التي ترسلها تختار الوضع. أرسل حقول وضع واحد لكل طلب.
| الوضع | ما ترسله | ملاحظات |
|---|---|---|
| من نص إلى فيديو | دون حقول الصور أو التمديد | يحدّد size الشكل. |
| من صورة إلى فيديو | image_urls | يبدأ المقطع بالصورة الأولى. |
| انتقال | first_frame_image + last_frame_image | 5 أو 8 ثوانٍ. |
| مراجع متعددة الصور | img_references (1–7 روابط URL) | يجمع شخصيات أو أشياء أو مشاهد من الصور؛ يحدّد size الشكل. |
| تمديد | extend_from_task_id | يتابع مهمة pixverse-v6 مكتملة خاصة بك. |
{
"model": "pixverse-v6",
"prompt": "The puppy slowly turns into a kitten, soft studio light.",
"first_frame_image": "https://example.com/puppy.jpg",
"last_frame_image": "https://example.com/kitten.jpg",
"duration": 5
}{
"model": "pixverse-v6",
"prompt": "The paper boat drifts on toward a lily pad.",
"extend_from_task_id": "task_...",
"resolution": "540p",
"duration": 5
}يعيد التمديد المقطع المصدر متبوعًا بالجزء الجديد، ويُحتسب duration للجزء الجديد فقط. في اختبارنا، أعاد تمديد مدته ثانية واحدة لمقطع مدته ثانية واحدة فيديو بطول 2.1 ثانية واحتُسب لثانية واحدة.
مدخلات الوسائط
الصور روابط HTTP(S) عامة. ولا تُقبل روابط data URI بصيغة base64: ارفع الملف إلى تخزينك الخاص ومرّر رابطه. استخدم صور JPG أو PNG أو WebP لا يتجاوز حجمها 20 MB.
عوامل التكلفة
راجع قسم أسعار النموذج للاطلاع على الأسعار الحالية. يُحتسب PixVerse V6 لكل ثانية من الفيديو، بسعر تحدّده الدقة وما إذا كان الصوت يُولَّد:
cost = duration × rate per second for the resolution and audio settingتكلّف كل الأوضاع المبلغ نفسه للثانية؛ ويُحتسب التمديد للجزء الجديد فقط. تُعرف المدة عند قبول الطلب، لذا فالمبلغ المحجوز هو المبلغ المحتسب. اطّلع على الرسوم النهائية في سجل استخدام حسابك. والمهام الفاشلة لا تُحتسب.
بنية المخرجات
يعيد الإرسال المهمة:
{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}جلب المهمة
GET https://api.seedrouter.ai/v1/tasks/{task_id}استعلم كل 10–20 ثانية حتى تصبح status بقيمة completed أو failed. انتهاء مهلة الشبكة أثناء الاستعلام لا يعني فشل التوليد: احتفظ بمعرّف المهمة وتابع التحقق منها. ولا تنشئ مهمة أخرى للتحقق من التقدّم.
المهمة المكتملة
{
"id": "task_...",
"model": "pixverse-v6",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689640,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}في اختباراتنا، عادت مقاطع 360p بنسبة 16:9 ومدتها ثانية واحدة بصيغة MP4 (H.264) بأبعاد 640 × 360، بعد 36–45 ثانية من الإرسال.
الأخطاء
الطلبات المرفوضة قبل إنشاء المهمة تعيد خطأ HTTP مع كائن error ولا تُحتسب. أما المهمة التي تفشل بعد قبولها فتعيد HTTP 200 عند الاستعلام عنها، مع status: "failed" وكائن error.
راجع فهرس الأخطاء المشترك للاطلاع على الرموز وحالات HTTP وإرشادات إعادة المحاولة.
{
"id": "task_...",
"model": "pixverse-v6",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}إذا انتهت مهلة الإرسال نفسه، فراجع مهامك قبل الإرسال مجددًا: فربما قُبل الطلب الأول.
نصائح
- صِف الموضوع والمكان وحركة الكاميرا والإضاءة في الموجّه؛ واذكر الأصوات التي تريدها عند تفعيل
audio. - أعدّ مسودة بدقة
360pأو540p، ثم ولّد اللقطة النهائية بدقة1080pبالطلب نفسه والبذرةseedنفسها. - للفيديو العمودي، أرسل
size: "9:16"مع التحويل من نص إلى فيديو، أو صورة عمودية. - أضف
no text, no logosلإبعاد العلامات المختلقة.
