# واجهة API لـ Pixverse V6 مرجع API كامل لنماذج توليد الفيديو Pixverse V6. تستخدم جميع المتغيرات نقطة نهاية مهمة الفيديو الموحدة. ## متغيرات النموذج | النموذج | المعرّف | الوصف | | ----- | --- | ----------- | | **Pixverse V6 Text to Video** | `pixverse-v6-text-to-video` | توليد فيديو من موجه نصي | | **Pixverse V6 Image to Video** | `pixverse-v6-image-to-video` | تحريك صورة واحدة كإطار أول | | **Pixverse V6 Transition** | `pixverse-v6-transition` | توليد انتقال بين صورة إطار أول وصورة إطار أخير | | **Pixverse V6 Extend** | `pixverse-v6-extend` | تمديد فيديو موجود بإطارات جديدة موجهة عبر `prompt` | ## مقارنة سريعة | الميزة | نص إلى فيديو | صورة إلى فيديو | انتقال | تمديد | | ------- | ------------- | -------------- | ---------- | ------ | | `prompt` | مطلوب | مطلوب | مطلوب | مطلوب | | `aspect_ratio` | اختياري (الافتراضي `16:9`)؛ راجع النسب المدعومة أدناه | غير مستخدم (يتبع صورة الإدخال) | غير مستخدم (يتبع صور الإدخال) | غير مستخدم (يتبع فيديو الإدخال) | | `image_url` | — | مطلوب | مطلوب (الإطار الأول) | — | | `image_end_url` | — | — | مطلوب (الإطار الأخير) | — | | `video_url` | — | — | — | مطلوب (الفيديو المصدر) | | `negative_prompt` | — | — | اختياري | اختياري | | `seed` | — | — | اختياري (`0` يعامل كإعدادات المنتج الافتراضية) | اختياري | | المدة | 1–15 seconds | 1–15 seconds | 1–15 seconds | 1–15 seconds | | الدقة | `360p`, `540p`, `720p`, `1080p` | نفسها | نفسها | نفسها | | الصوت | اختياري عبر `sound` | اختياري عبر `sound` | اختياري عبر `sound` | اختياري عبر `sound` | تدعم نماذج text-to-video نسب العرض إلى الارتفاع: `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3`. ## Pixverse V6 Text to Video ### نقطة النهاية ``` POST /api/v1/video/task ``` ### معاملات الطلب #### مطلوب | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `model_name` | string | يجب أن يكون `"pixverse-v6-text-to-video"` | | `prompt` | string | موجه توليد الفيديو | | `duration` | integer | طول الفيديو بالثواني (`1`–`15`) | | `resolution` | string | واحد من `360p`, `540p`, `720p`, `1080p` | #### اختياري | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `aspect_ratio` | string | الافتراضي `16:9`. واحد من `21:9`, `16:9`, `9:16`, `1:1`, `4:3`, `3:4`, `3:2`, `2:3` | | `sound` | boolean | ما إذا كان سيتم توليد صوت للفيديو | ### مثال طلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-text-to-video', prompt: 'A cinematic street scene at night with neon reflections', duration: 8, resolution: '1080p', aspect_ratio: '16:9', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Image to Video ### معاملات الطلب #### مطلوب | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `model_name` | string | يجب أن يكون `"pixverse-v6-image-to-video"` | | `prompt` | string | موجه توليد الفيديو | | `duration` | integer | طول الفيديو بالثواني (`1`–`15`) | | `resolution` | string | واحد من `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | عنوان URL لصورة الإطار الأول | #### اختياري | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `sound` | boolean | ما إذا كان سيتم توليد صوت للفيديو | ### مثال طلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-image-to-video', prompt: 'Fluid camera pan; maintain subject identity', duration: 6, resolution: '720p', image_url: 'https://example.com/first-frame.jpg', sound: true, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Transition يولّد حركة بين صورة مفتاحية **أولى** وصورة مفتاحية **أخيرة**. يدعم الموجه السلبي الاختياري وseed. ### معاملات الطلب #### مطلوب | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `model_name` | string | يجب أن يكون `"pixverse-v6-transition"` | | `prompt` | string | يصف الحركة بين الإطارين | | `duration` | integer | طول الفيديو بالثواني (`1`–`15`) | | `resolution` | string | واحد من `360p`, `540p`, `720p`, `1080p` | | `image_url` | string | عنوان URL لصورة الإطار الأول | | `image_end_url` | string | عنوان URL لصورة الإطار الأخير | #### اختياري | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `sound` | boolean | ما إذا كان سيتم توليد صوت للفيديو | | `negative_prompt` | string | محتوى يراد تقليل ظهوره في المخرجات | | `seed` | integer | seed العشوائية؛ يتبع `0` سلوك العشوائية الافتراضي للمنصة | ### مثال طلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-transition', prompt: 'Seamless blend with natural lighting continuity', duration: 6, resolution: '720p', image_url: 'https://example.com/start.jpg', image_end_url: 'https://example.com/end.jpg', sound: true, negative_prompt: 'blur, watermark, text overlay', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Pixverse V6 Extend يتابع مقطعا موجودا. قدّم عنوان URL للفيديو المصدر وموجها يصف كيف ينبغي أن تتقدم القصة. ### معاملات الطلب #### مطلوب | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `model_name` | string | يجب أن يكون `"pixverse-v6-extend"` | | `prompt` | string | يصف كيف ينبغي أن يستمر الفيديو | | `duration` | integer | طول الفيديو بالثواني (`1`–`15`) | | `resolution` | string | واحد من `360p`, `540p`, `720p`, `1080p` | | `video_url` | string | عنوان URL للفيديو المصدر المطلوب تمديده | #### اختياري | المعامل | النوع | الوصف | | --------- | ---- | ----------- | | `sound` | boolean | ما إذا كان سيتم توليد صوت للفيديو | | `negative_prompt` | string | محتوى يراد تقليل ظهوره في المخرجات | | `seed` | integer | seed العشوائية؛ يتبع `0` سلوك العشوائية الافتراضي للمنصة | ### مثال طلب ```javascript const response = await fetch('https://api.flaq.ai/api/v1/video/task', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ model_name: 'pixverse-v6-extend', prompt: 'Continue the walk into the forest clearing', duration: 5, resolution: '720p', video_url: 'https://example.com/source-clip.mp4', sound: false, negative_prompt: 'low quality, jitter', seed: 0, }), }); const { data } = await response.json(); const taskId = data.task_id; ``` ## تنسيق الاستجابة ### الاستجابة الأولية ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "submitted" } } ``` ### استجابة الاستعلام استعلم من `GET /api/v1/video/{taskId}` للتحقق من الحالة: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/video/{task_id}", "task_status": "succeed", "task_status_msg": null, "task_result": { "credit": 0.2, "videos": [ { "url": "https://example.com/generated-video.mp4" } ] } } } ``` ### قيم الحالة - `submitted`: تم قبول المهمة وهي بانتظار المعالجة - `processing`: توليد الفيديو قيد التنفيذ - `succeed`: اكتمل توليد الفيديو - `failed`: فشل توليد الفيديو ## أفضل الممارسات 1. **التمديد**: استخدم فيديو مصدرا نظيفا ومستقرا حتى يتمكن النموذج من متابعة الحركة دون عيوب. 2. **الانتقال**: اجمع بين `negative_prompt` و`seed` عندما تحتاج إلى اختبارات انتقال قابلة للتكرار. 3. **الدقة**: طابق `resolution` مع هدف التسليم؛ تستغرق الدقات الأعلى وقتا أطول للمعالجة. 4. **الاستعلام**: استعلم كل 5–10 ثوان حتى تصبح `task_status` هي `succeed` أو `failed`.