قرأ مطوران وثائق PixVerse هذا الصباح. أحدهم نشر ميزة prompt سلبي. الآخر تعلم أن هذه المعلمة لم تعد موجودة.
كلاهما كان يقرأ صفحات رسمية. هذه هي الحالة الحقيقية لواجهة PixVerse API في عام 2026: خدمة توليد فيديو سريعة وقادرة، ملفوفة في وثائق حيث تتناقض الصفحات القديمة والجديدة بهدوء. معظم أسئلة مطوري PixVerse AI API تتركز حول أمرين: أين توجد الوثائق الحالية بالفعل؟ وما هي تكلفة المقطع بمجرد أن يعمل الكود؟
يجيب هذا الدليل على كليهما. كل نقطة نهاية ومعلمة وسعر أدناه تم التحقق منها مقابل صفحات الطرف الأول هذا الأسبوع، في 23 يوليو 2026.
النقاط الرئيسية
- وثائق PixVerse API الرسمية موجودة على docs.platform.pixverse.ai. المفاتيح والائتمانات موجودة على platform.pixverse.ai. تطبيق المستهلك على app.pixverse.ai هو منتج منفصل بفواتير منفصلة.
- كل طلب يحتاج إلى رأسين: API-KEY بالإضافة إلى Ai-trace-id UUID جديد لكل طلب. التوليد غير متزامن: أرسل، احصل على video_id، استقصِ النتيجة.
- الوثائق تتعارض مع بعضها في بعض الأماكن. الصفحات التعليمية القديمة لا تزال تظهر negative_prompt و water_mark؛ مرجع التوليد الحالي لا يحتوي على أي منهما. عندما تختلف الصفحات، ثق بمرجع نقطة النهاية.
- الفوترة الرسمية بالائتمانات (10 دولارات تشتري 1,000). نفس نموذج V6 يعمل بنظام القياس على Atlas Cloud من 0.025 دولار في الثانية، حيث تكلفة المقطع الافتراضي 5 ثوانٍ بدقة 720p مع الصوت 0.30 دولار مقابل 0.60 دولار بأسعار الحزم الائتمانية.
خريطة وثائق PixVerse API: أين تعيش الوثائق الحقيقية
البحث عن وثائق PixVerse API يعيد أربع واجهات من الطرف الأول ومجموعة من البائعين. الأربعة المهمة:
| السطح | الرابط | ما يغطيه |
|---|---|---|
| وثائق المنصة | docs.platform.pixverse.ai | بداية سريعة، مرجع API كامل، تسعير الائتمانات، مرجع الأخطاء، الأسئلة الشائعة |
| لوحة التحكم للمطورين | platform.pixverse.ai | إنشاء مفاتيح API، شراء حزم الائتمانات، تتبع الاستخدام |
| تطبيق المستهلك | app.pixverse.ai | تطبيق الويب. خططه وائتماناته المجانية وقواعد العلامة المائية لا تنطبق على API |
| خادم MCP الرسمي | github.com/PixVerseAI/PixVerse-MCP | غلاف رسمي يسمح للمساعدين بالذكاء الاصطناعي باستدعاء PixVerse مباشرة |
الفارق الذي يوقع الناس في المشاكل هو التطبيق مقابل المنصة. التطبيق يبيع خططًا شهرية من 10 دولارات ويوزع ائتمانات مجانية يومية متغيرة. المنصة تبيع ائتمانات API وعضويات على دفتر أستاذ منفصل. الاشتراك المدفوع في التطبيق لا يعطيك شيئًا على جانب API والعكس صحيح.
تفصيلة مفيدة حقًا تختبئ في وثائق المنصة: صفحة نصية عادية مجمعة باسم PixVerse-api-llm.txt تحتوي على مرجع API كامل في مستند واحد. الصقها في مساعد البرمجة الخاص بك وسيكون قادرًا على كتابة استدعاءات PixVerse وفقًا للمواصفات الحالية بدلاً من ما تتذكره بيانات تدريبه.
تصف الوثائق خدمة وراء "أكثر من 100 مليون منشئ ومؤسسة عبر 175 دولة." النطاق حقيقي. تقلب الإصدارات المصاحب هو سبب وجود قسم التناقضات في هذه المقالة.
طريقتان لاستخدام PixVerse AI API اليوم
التكامل مع منصة PixVerse الخاصة يحصل على شرح كامل في القسم التالي. أسرع طريقة لتجربة النماذج أولاً هي من خلال مضيف: Atlas Cloud يدير PixVerse V6 و C1 بين أكثر من 400 نموذج، مفوترة بالثانية بالدولار بدون حزم ائتمانية وبدون علامة مائية. صفحة عائلة PixVerse تسرد جميع نقاط النهاية التسعة المستضافة، من نص إلى فيديو إلى مرجع إلى فيديو وتمديد. طريقتان للدخول: اختبر في الملعب، ثم استدع نفس نقطة النهاية من الكود. نقطة البداية الطبيعية هي ملعب V6 للنص إلى فيديو.
الطريقة 1: اختبر PixVerse V6 API في الملعب
قبل كتابة الكود، اقضِ عشر دقائق هنا. الملعب هو نفس نقطة النهاية التي سيدعوها الكود الخاص بك، مع عرض سعر مرفق.
- سجل الدخول وافتح الملعب. حقل المطالبة هو المدخل المطلوب الوحيد.
- اضبط المدة والجودة ونسبة العرض إلى الارتفاع. الإعدادات الافتراضية هي 5 ثوانٍ، 720p، 16:9.
- تحقق من مفتاح الصوت. الصوت قيد التشغيل افتراضيًا ويرفع السعر في الثانية.
- اقرأ زر التشغيل. يظهر التكلفة الدقيقة لإعداداتك الحالية. عند الإعدادات الافتراضية، هذا هو 0.30 دولار، لذا 10 دولارات تغطي حوالي 33 عملية تشغيل.
- شغّل، راجع، حمّل. كرر على المطالبة حتى يصبح الناتج جيدًا، ثم انقل هذا التكوين الدقيق إلى الكود.
الطريقة 2: استدع PixVerse V6 API من الكود
سير عمل مطور PixVerse V6 على Atlas Cloud هو طلبين HTTP.
الخطوة 1: احصل على مفتاح API الخاص بك. أنشئ مفتاحًا في لوحة تحكم Atlas Cloud واحفظه كمتغير بيئة، وليس في كود العميل أبدًا.
الصورة: لقطة شاشة لصفحة مفاتيح API في لوحة تحكم Atlas Cloud، تظهر زر إنشاء مفتاح ومفتاحًا تم إنشاؤه حديثًا بجوار عنصر التحكم في النسخ.
الخطوة 2: تحقق من وثائق API. نقاط النهاية والمعلمات والمصادقة موجودة في توثيق API.
الخطوة 3: أرسل طلبك الأول. أرسل المهمة:
plaintext1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \ 2 -H "Content-Type: application/json" \ 3 -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \ 4 -d '{ 5 "model": "pixverse/v6/text-to-video", 6 "prompt": "لقطة دولي بطيئة عبر سوق ليلي مبتل بالمطر، لافتات نيون تنعكس في البرك، بخار يتصاعد من أكشاك الطعام", 7 "duration": 5, 8 "quality": "720p", 9 "aspect_ratio": "16:9", 10 "sound": true 11 }'
الاستجابة ترجع معرّف تنبؤ. استقصِ عنه حتى تصبح الحالة مكتملة:
plaintext1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \ 2 -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
الاستجابة المكتملة تحمل رابط الفيديو المستضاف. الفائدة الدائمة هي شكل الطلب: Atlas Cloud يدير API واحد عبر كل نموذج، لذا مفتاح واحد ورأس مصادقة واحد وحلقة واحدة من الإرسال والاستقصاء تغطي PixVerse اليوم وأي شيء تضيفه لاحقًا. تغيير النماذج يعني تغيير سلسلة النموذج فقط، لا شيء آخر.
داخل وثائق PixVerse AI API الرسمية: كيف يعمل الاستدعاء فعليًا
إذا كنت تتكامل مع منصة PixVerse الخاصة بدلاً من ذلك، فإن نظرة عامة على API تحدد تدفقًا من ثلاث مراحل مقابل النطاق الأساسي app-api.pixverse.ai:
| المرحلة | نقطة النهاية | ملاحظات |
|---|---|---|
| رفع (للصور إلى فيديو فقط) | POST /openapi/v2/image/upload | نموذج متعدد الأجزاء. PNG أو WebP أو JPEG تحت 20 ميجابايت. يعيد img_id عددًا صحيحًا |
| توليد | POST /openapi/v2/video/text/generate | جسم JSON. يعيد video_id |
| استقصاء | GET /openapi/v2/video/result/{video_id} | الحالة 1 تعني مكتمل، مع رابط تحميل في الاستجابة |
المصادقة تتطلب رأسين على كل طلب. API-KEY يحمل المفتاح من لوحة تحكم المنصة. Ai-trace-id يجب أن يكون UUID جديدًا لكل طلب؛ تحذر الوثائق من أن إعادة استخدامه يمنع بدء عمليات توليد جديدة.
المرجع الحالي للتوليد من نص إلى فيديو يشير إلى خمسة حقول مطلوبة: prompt (حتى 5,000 حرف)، model، duration، quality، و aspect_ratio. تعداد model يقبل ثماني قيم، من v3.5 إلى v5.6 بالإضافة إلى v6 و c1، وحدود المدة تتبع التوليد: 5 أو 8 ثوانٍ حتى v5، خيار 10 ثوانٍ على v5.5 و v5.6، وأي 1 إلى 15 ثانية على v6 و c1. الصوت اختياري من خلال generate_audio_switch، والذي يكون افتراضيًا false. هذه القيمة الافتراضية مهمة للميزانية: ملعب Atlas Cloud أعلاه يجعل الصوت افتراضيًا على تشغيل، لذا المساران يقتبسان أسعارًا مختلفة لما يبدو وكأنه نفس المقطع.
الصورة إلى فيديو تضيف خطوة الرفع أولاً. لا يوجد تمرير رابط صورة عامة؛ ترفع الملف، تأخذ img_id المرتجع، وتشير إليه في جسم التوليد.
حقيقتان تشغيليتان تكملان الصورة، كلاهما من مرجع الأخطاء. عمليات التوليد المتزامنة محدودة بمستوى العضوية، والفتحة العالقة تتحرر بعد حوالي 10 دقائق. كما أن حالات الاستقصاء تستحق المعالجة بوضوح: 7 يعني أن المطالبة تسببت في اعتدال المحتوى، 8 يعني فشل من جانب الخادم يستحق إعادة المحاولة.
أين تتعارض وثائق PixVerse API مع نفسها
وثائق PixVerse API هي مزيج من مراجع نقاط النهاية الحالية وصفحات تعليمية أقدم لم يتم تحديثها بالكامل. قراءة الصفحة الخاطئة تكلف وقتًا حقيقيًا في التصحيح. التناقضات التي تحققنا منها مباشرة:
| الموضوع | صفحة الوثائق الأقدم تقول | المرجع الحالي يقول |
|---|---|---|
| negative_prompt | معروض في أجسام طلبات المثال في نظرة عامة API | ليس حقلًا في نقطة نهاية التوليد |
| water_mark | "water_mark": false يظهر في نفس الأمثلة | غائب عن قائمة المعلمات الحالية |
| طول المقطع | README في MCP يحدد "5s أو 8s" | أي 1 إلى 15 ثانية على v6 و c1 |
| حد رفع الصورة | صفحة استكشاف الأخطاء: 4000×4000 بكسل | مرجع الرفع: 10,000 بكسل |
| طول المطالبة | دليل إرشادي: حافظ على المطالبات من 25 إلى 200 كلمة | حد أقصى 5,000 حرف، بدون إرشاد للكلمات |
قاعدتان تغطيان جميع الصفوف الخمسة. عندما تختلف الصفحات، ثق بمرجع نقطة النهاية على الصفحة التعليمية؛ المراجع تحمل المواصفات الحالية، الأدلة تحمل التاريخ. وعندما تختلف الحدود، قم بالبرمجة إلى الحد الأكثر صرامة، لذلك 4000 بكسل على الرفعات.
تعداد الإصدارات يستحق تحذيرًا خاصًا به. أسماء النماذج القديمة لا تزال تعمل: v3.5 و v4 و v4.5 تظل قيمًا صالحة، لذا لم تتكسر عمليات التكامل من عام 2025. إنهم فقط يدفعون أكثر. بدقة 720p لمدة 5 ثوانٍ بدون صوت، الفوترة الرسمية تفرض 60 ائتمانًا على V4 ولكن 45 على V6. إذا ورثت قاعدة كودية بسلسلة نموذج قديم، ترقيتها هو تغيير من سطر واحد يقلل التكلفة ويحسن الناتج. فقط جيل V2 اختفى من الوصول المباشر للطرف الأول تمامًا.
تسعير PixVerse API: الائتمانات على المنصة، الدولارات على Atlas Cloud
منصة PixVerse الرسمية تفوترة بالائتمانات، وصفحة التسعير تسمي جداول النماذج "محسوبة في الثانية." حزم الائتمانات تتراوح من 10 دولارات مقابل 1,000 ائتمان إلى 5,000 دولار مقابل 500,000، مع عضويات شهرية من خطة Essential بقيمة 100 دولار (15,000 ائتمان) وصولاً إلى طبقة Business بقيمة 6,000 دولار. استهلاك الائتمان في الثانية للنماذج الحالية:
| الجودة | V6 (بدون صوت / مع صوت) | C1 (بدون صوت / مع صوت) |
|---|---|---|
| 360p | 5 / 7 ائتمانات | 6 / 8 ائتمانات |
| 540p | 7 / 9 ائتمانات | 8 / 10 ائتمانات |
| 720p | 9 / 12 ائتمانات | 10 / 13 ائتمانات |
| 1080p | 18 / 23 ائتمانات | 19 / 24 ائتمانات |
Atlas Cloud يقيس نفس النموذجين بالدولار في الثانية، بدون حزمة أو عضوية مسبقًا. تم التحقق في صفحات النماذج الحية في 23 يوليو 2026، بسعر القائمة بدون خصم جارٍ:
| الجودة | V6 (بدون صوت / مع صوت) | C1 (بدون صوت / مع صوت) |
|---|---|---|
| 360p | 0.025 دولار / 0.035 دولار | 0.030 دولار / 0.040 دولار |
| 540p | 0.035 دولار / 0.045 دولار | 0.040 دولار / 0.050 دولار |
| 720p | 0.045 دولار / 0.060 دولار | 0.050 دولار / 0.065 دولار |
| 1080p | 0.090 دولار / 0.115 دولار | 0.095 دولار / 0.120 دولار |
مقطع واحد يجعل المقارنة ملموسة. مقطع V6 بدقة 720p لمدة 5 ثوانٍ مع الصوت يكلف 60 ائتمانًا: هذا 0.60 دولار بسعر حزمة 10 دولارات، أو حوالي 0.40 دولار بسعر عضوية Essential بعد الالتزام بـ 100 دولار للشهر. مقاسًا على Atlas Cloud، نفس المقطع هو 0.30 دولار. نموذج C1 يسعر أعلى قليلاً في الثانية، 0.325 دولار لنفس المقطع من خلال ملعب C1، والذي يشتري ضبطه للإنتاج السينمائي.
الائتمانات لا تزال منطقية للفرق الموجودة بالفعل داخل منصة PixVerse، خاصة في حجم طبقة Scale حيث ينخفض السعر الفعلي. بالنسبة للآخرين، تسعير الدولار في الثانية أسهل في التوقع: سعر العرض هو المدة مضروبة في السعر، يمكن قراءته قبل الإنفاق.
شركة مطوري PixVerse AI وراء API
API هو رهان على الشركة التي تديره، وشركة مطوري PixVerse AI تستحق المعرفة قبل البناء. PixVerse مبنية من قبل AISphere (Aishi Technology)، تأسست في أبريل 2023 في بكين ومقرها الآن في سنغافورة مع حوالي 150 موظفًا. المؤسس والرئيس التنفيذي Wang Changhu أدار عمل مختبر AI في ByteDance في الرؤية من 2017 إلى 2021، مما يجعل PixVerse منافسًا مباشرًا لـ Seedance، المبني من قبل صاحب العمل السابق له. المؤسس المشارك Jaden Xie جاء من Lighthouse Capital.
الصورة التمويلية قوية بشكل غير عادي لمتجر نماذج فيديو مستقل. في 13 يوليو 2026، أغلقت الشركة تمديدًا من السلسلة C جلب الجولة إلى 439 مليون دولار بتقييم يتجاوز 2 مليار دولار، مع انضمام Alibaba، وفقًا لـ TechCrunch. بالنسبة للمطور، هذا يقرأ كمدرج: API الذي تدمجه هذا الربع من غير المرجح أن يختفي العام المقبل.
الجانب الآخر لمختبر ممول جيدًا هو سرعة الشحن. خط إصدارات 2026 وحده:
ثلاثة إطلاق نماذج في غضون ثلاثة أشهر يفسر التأخر في التوثيق الذي تستمر هذه المقالة في الإشارة إليه. ابنِ وفقًا لذلك: ثبت سلسلة النموذج الخاص بك، اقرأ ملاحظات الإصدار قبل رفعها، وأعد التحقق من مرجع نقطة النهاية بدلاً من افتراض أن معلمات الربع السابق قد نجت.
الأسئلة الشائعة
أين توجد وثائق PixVerse API الرسمية؟
في docs.platform.pixverse.ai، مع لوحة تحكم المطور على platform.pixverse.ai. أي شيء مستضاف على app.pixverse.ai هو منتج المستهلك، وصفحات "وثائق PixVerse API" من جهات خارجية تصف غالبًا معلمات من عصر v4. تتضمن الوثائق أيضًا صفحة نصية مجمعة جاهزة لنماذج اللغة الكبيرة يمكنك إطعامها لمساعد البرمجة.
كيف أحصل على مفتاح PixVerse API؟
سجل في لوحة تحكم المنصة على platform.pixverse.ai، أنشئ مفتاحًا، وقم بتمريره في رأس API-KEY بالإضافة إلى Ai-trace-id UUID فريد لكل طلب. المفاتيح مرتبطة بائتمانات المنصة، والتي يتم شراؤها بشكل منفصل عن أي اشتراك في تطبيق المستهلك. على Atlas Cloud، المكافئ هو مفتاح لوحة تحكم يتم تمريره كرمز Bearer قياسي.
هل لدى PixVerse API طبقة مجانية؟
وثائق تسعير المنصة تسرد فقط حزم الائتمانات والعضويات المدفوعة. الائتمانات المجانية اليومية المتغيرة التي تعلن عنها PixVerse تنتمي إلى تطبيق المستهلك ولا تتدفق إلى دفتر أستاذ API. أرخص نقاط الدخول المدفوعة هي حزمة ائتمانية بقيمة 10 دولارات على المنصة الرسمية أو توليد مقاس من 0.025 دولار في الثانية على Atlas Cloud.
ما هي النماذج التي يمكن أن يشغلها PixVerse API؟
نقطة نهاية التوليد الحالية تقبل ثماني قيم للنماذج: v3.5، v4، v4.5، v5، v5.5، v5.6، v6، و c1. V6 و C1 هما الجيل الحالي، بمقاطع من 1 إلى 15 ثانية وصوت أصلي اختياري. الأسماء القديمة لا تزال تعمل ولكنها تكلف ائتمانات أكثر بنفس الإعدادات مقارنة بـ V6. جيل V2 لم يعد متاحًا من الطرف الأول.
كم تكلفة PixVerse AI API لكل فيديو؟
المنصة الرسمية: مقطع V6 بدقة 720p لمدة 5 ثوانٍ مع الصوت هو 60 ائتمانًا، حوالي 0.60 دولار بسعر حزمة 10 دولارات. Atlas Cloud: نفس المقطع هو 0.30 دولار مقاسًا، من نطاق في الثانية من 0.025 دولار إلى 0.115 دولار حسب الدقة والصوت. C1 أعلى قليلاً، 0.325 دولار لهذا المقطع. الأسعار تم التحقق منها في 23 يوليو 2026.
الخاتمة
PixVerse API في حالة أفضل من وثائقها. الخدمة نفسها سريعة وممولة جيدًا وحالية: ثماني قيم للنماذج، مقاطع تصل إلى 15 ثانية، صوت في نفس الممر، وتدفق غير متزامن يمكن لأي مطور مبتدئ توصيله في فترة ما بعد الظهر. الوثائق فقط لم تواكب تقويم الإصدارات، لذا تشير مراجع نقاط النهاية والأدلة الإرشادية إلى منتجات مختلفة.
الطريقة العاملة بسيطة. ثق بمرجع نقطة النهاية، برمج إلى الحد الأكثر صرامة عندما تختلف الصفحات، وثبت سلسلة النموذج الخاص بك. ثم اختر شكل الفوترة الخاص بك: ائتمانات على المنصة الرسمية إذا كان فريقك يعيش هناك بالفعل، أو دولارات في الثانية من 0.025 دولار إذا كنت تريد سعر كل عرض يمكن قراءته قبل إرساله. المقطع الافتراضي بقيمة 0.30 دولار في الملعب هو مكان رخيص لمعرفة أي جانب أنت عليه.
