مرجع API

ما هي واجهة API

تتيح واجهة MyDreamVid API لبرمجياتك إنشاء الفيديو والصور بنماذج Seedance وSeedream دون أن ينقر أحد في الاستوديو. يرسل برنامجك موجّهًا (وملفات مرجعية اختيارية)، فنجري فحوص الأمان نفسها ونطبّق الأسعار نفسها كما في استوديو الويب، ثم يستلم برنامجك الملف الجاهز. تُخصم النقاط من رصيد الحساب نفسه.

لمن هي

• الفرق التي تنشئ بكميات كبيرة: كتالوجات المنتجات، نسخ الإعلانات، مقاطع التواصل، والنسخ المترجمة من فيديو واحد.
• المطورون الذين يضيفون إنشاء الفيديو أو الصور إلى تطبيقهم أو أداتهم أو بوتهم أو خط أنابيبهم الداخلي.
• الوكالات والاستوديوهات التي تريد واجهتها الأمامية الخاصة بينما نتولى نحن النماذج والطوابير والفوترة.

إذا كنت تصنع بضعة فيديوهات أسبوعيًا يدويًا فلا تحتاج إلى API. الاستوديو يفعل كل ما تفعله الواجهة وبالأسعار نفسها.

المصادقة

كل طلب يحمل مفتاح bearer. تُنشأ المفاتيح في الاستوديو وتُعرض مرة واحدة فقط.

• الترويسة: Authorization: Bearer mdv_live_…
• صلاحية write يمكنها إنشاء المهام وإلغاؤها ورفع الملفات؛ صلاحية read تقتصر على العرض والجلب.
• تتاح المفاتيح بعد شحن باقة Creator ($25) أو Studio ($50). النقاط لا تنتهي صلاحيتها.
• واجهة API مصممة للاستدعاء من خادمك. لا تضع المفاتيح في شيفرة المتصفح أو تطبيقات الجوال.

اعرف السعر أولًا

كل مهمة تكلف نقاطًا (1 نقطة = $0.01). اطلب عرض سعر قبل الإنشاء: فهو مجاني ولا يحتاج Idempotency-Key ويعيد بالضبط ما ستحجزه المهمة. الرقم نفسه يعود في credits_reserved عند إنشاء المهمة، وcredits_charged في المهمة المكتملة هو ما دفعته فعلًا (أي جزء غير مستخدم من الحجز يُعاد).

GET /v1/credits يعرض رصيدك المتاح والمحجوز في أي وقت. المهام المُنشأة عبر API تظهر أيضًا في الاستوديو ضمن «إبداعاتي» وفي سجل النقاط.

نقاط النهاية

• GET /v1/models — النماذج مع المدد والدقات والنسب وأسعار النقاط لكل ثانية وحدود المراجع.
• POST /v1/videos/quote — تكلفة النقاط الدقيقة لمهمة. مجاني، بلا حجز.
• POST /v1/videos — إنشاء مهمة. الجسم: kind (t2v | i2v | r2v) وmodel وprompt وduration_s وresolution وratio، واختياريًا generate_audio وreferences. يتطلب Idempotency-Key.
• GET /v1/videos/{id} — حالة المهمة؛ المهمة المكتملة تحمل video_url.
• GET /v1/videos — مهامك، الأحدث أولًا، بترقيم صفحات بالمؤشر (limit وcursor).
• POST /v1/videos/{id}/cancel — إلغاء مهمة بحالة waiting أو queued.
• POST /v1/files/presign — فتحة رفع لملف مرجعي: صورة أو فيديو أو صوت.
• POST /v1/files/{media_id}/confirm — إنهاء الرفع: يُفحص الملف تقنيًا وأمنيًا ثم يصبح قابلًا للاستخدام كمرجع.
• GET /v1/credits — النقاط المتاحة والمحجوزة.

الحدود

• 60 طلبًا في الدقيقة لكل مفتاح.
• مهمتان قيد التنفيذ (waiting أو queued أو running) لكل حساب عبر API.
• مسارات كل نموذج مشتركة بين الجميع؛ عند امتلاء المسار تنتظر مهمتك بالترتيب وتُرسل تلقائيًا.
• حتى 5 مفاتيح نشطة لكل حساب.
• الملفات: الصور حتى 10 MB، الفيديو حتى 50 MB، الصوت حتى 20 MB. يجب ألا يقل الفيديو المرجعي عن ثانيتين؛ ويمكن أن يصل الفيديو والصوت إلى 5 دقائق كحد أقصى.