إطلاق واجهة برمجة التطبيقات للمطورين في ClipMixAI

نفتح اليوم المحركات التي تشغّل تطبيق ClipMixAI الإلكتروني أمام كل من يرغب في البناء عليها. تتيح واجهة برمجة التطبيقات للمطورين الجديدة على api.clipmixai.com/api/v1 أربع خدمات — ترجمة الفيديو، فيديو الذكريات، تبديل الوجوه والأفاتار، والموسيقى بالذكاء الاصطناعي — عبر سطح REST موحد يعتمد نظام Bearer token. نفس النماذج، نفس الجودة، نفس الأرصدة. لا اشتراك مطلوب. لا حد أدنى.

إن أردت تخطي التفاصيل: /api للعرض التعريفي، /api/docs للمرجع التقني، و/dashboard/api-keys لإنشاء مفتاحك.

لماذا بنيناها

على مدار العام الماضي، رأينا مستخدمين يكررون نفس الخطوات مراراً: فتح لوحة التحكم، رفع 30 صورة، النقر على إنشاء، انتظار الأغنية، ثم نقل الناتج يدوياً إلى أداة تحرير منفصلة. كان لدينا مؤسسون يترجمون محتوى صانعي الفيديو إلى 10 لغات، ووكالات تنتج 100 إعلان علامة تجارية أسبوعياً، واستوديوهات ألعاب مستقلة تولّد موسيقى مؤقتة للنماذج الأولية. وفي النهاية كان الجميع يسأل نفس السؤال: "هل يوجد API؟"

الجواب الآن: نعم. الخدمات الأربع التي كانت تحرّك كل هذه السير تُستدعى الآن مباشرةً من كودك — دون الحاجة للوحة التحكم، ودون أن تتعلم تفاصيل كل مزوّد، وبنفس التسعير القائم على الأرصدة الذي تعرفه من التطبيق. إذا كانت مهمة كانت تستغرق ساعة بشرياً يمكنها الآن أن تعمل في الخلفية عبر مهمة CRON، فذلك هو الهدف.

البداية السريعة

أنشئ مفتاحاً من لوحة التحكم، ثم:

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

ستحصل فوراً على job-id مع status: "processing". إما أن تستعلم عبر GET /v1/music/{id} حتى يتغير الحالة إلى completed، أو — والأفضل — أن تربط webhook بمفتاحك عند إنشائه، وسنرسل النتيجة النهائية إلى نقطة النهاية الخاصة بك، موقّعةً بـ HMAC-SHA256 حتى تتحقق أنها صادرة منّا.

ثلاثة أشياء طلبها المطوّرون ولم نوفّرها من قبل

1. مفاتيح بيئة التجربة

لكل مفتاح API وضع: sk_live_ يستهلك الأرصدة ويستدعي المزوّدين الفعليين؛ أما sk_test_ فلا يكلّفك شيئاً ولا يستدعي أي مزوّد، بل يعيد مهمة completed اصطناعية تحتوي على test: true في الجسم. استخدم مفاتيح بيئة التجربة في CI للتحقق من التكامل دون استهلاك أرصدة، وانتقل إلى المفاتيح الحقيقية حين تريد نتيجة فعلية.

مفاتيح بيئة التجربة مجانية للجميع — بما فيهم حسابات المستوى المجاني. الشرط الوحيد لاستخدام مفتاح حقيقي هو عملية شراء رصيد واحدة سابقة، وهو نفس شرط الدفع المعمول به في التطبيق.

2. مفتاح الاتساق على كل طلب POST

إعادة المحاولات الشبكية كابوس لكل واجهة API حساسة للفوترة. استعرنا حل Stripe: أرسل Idempotency-Key: <نصك> مع أي طلب إنشاء، وسيحتفظ الخادم بالاستجابة لمدة 24 ساعة. إعادة المحاولة بنفس المفتاح ونفس الجسم تعيد الاستجابة الأصلية — دون تكرار الفوترة أبداً. أما إعادة المحاولة بنفس المفتاح لكن جسم مختلف فتعيد 422 idempotency_key_reuse لتكتشف الخطأ بدلاً من إنتاج مهمة خاطئة بصمت.

يتيح كلا SDK الرسميين ذلك عبر وسيطة واحدة:

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. Webhooks مع زر اختبار فوري

اضبط رابط callback على مفتاحك وسنرسل أحداث job.completed / job.failed فور انتهاء المهام. يحمل كل تسليم توقيع HMAC في X-ClipMix-Signature: sha256=<hex> — تحقق منه بمساعد واحد من أي SDK. في حال فشل التسليم، تُعاد المحاولة بأسلوب التراجع الأسّي (0 ثانية ← 30 ثانية ← 5 دقائق ← ساعة، أربع محاولات إجمالاً).

تتضمن لوحة التحكم زر إطلاق اختباري يرسل حدث webhook.test اصطناعياً لتتحقق من توقيع نقطة نهايتك وتحليلها دون انتظار مهمة حقيقية. تعرض نفس اللوحة سجل تسليم يضم 100 صف لكل مفتاح، حتى لا تضطر للتخمين حين يسوء الأمر.

ثلاثة حالات استخدام نراها فعلاً

ترجمة الفيديو بالجملة لصانعي المحتوى

ارفع فيديو واحد واحصل على 10 نسخ مدبلجة بـ 10 لغات، مع خيار استنساخ الصوت للحفاظ على نبرة المتحدث. لدينا صانع محتوى على YouTube يترجم بودكاست أسبوعيه إلى 9 لغات تلقائياً — يُطلَق استدعاء الـ API من خطاف النشر الموجود، والـ webhook يُسقط الملف المدبلج في نظام إدارة المحتوى مباشرةً.

فيديوهات علامة تجارية مخصصة لكل عميل

يتيح ناتج تحويل الصور إلى فيديو لمتجر إلكتروني أخذ صورة منتج العميل وتوليد إعلان سينمائي قصير مخصص لذلك المنتج. تكشف نقطة النهاية family-videos عن الأوضاع الأربعة (Moment وStory وAlbum وChronicle) التي بنيناها لواجهة المستهلك؛ وتستخدمها الوكالات كمحرك داخل أدوات ذات علامات تجارية خاصة.

نماذج أولية للصوت في الألعاب

تستدعي الاستوديوهات المستقلة نقطة النهاية /v1/music من داخل خط أنابيب أصولها الداخلي. يكتب مصمم اللعبة مزاجاً وكلمات مؤقتة، فيصل مقطع من 60 ثانية إلى مجلد الصوت في المشروع بعد عشر دقائق. يكرّرون على الموسيقى المؤقتة في ثوانٍ بدلاً من انتظار مصمم الصوت لكل تغيير.

الإصدارات وما نلتزم به

الإصدار v1 مستقر. لن ندخل تغييرات كاسرة داخل /api/v1/ — الحقول والنقاط الجديدة إضافية فقط، والسطح الحالي يبقى كما هو. أي شيء نضطر لكسره (نادراً) يُشحن تحت /api/v2/ مع فترة انتقالية معلنة. سجل التغييرات هو المرجع الأساسي.

الحالة التشغيلية متاحة مباشرةً على /api/status — لقطة صحية لكل خدمة مستمدة من حركة المرور الفعلية خلال الـ 5 دقائق الأخيرة. تُحدَّث كل 60 ثانية وهي نفس العرض الذي يرصده فريق الاستجابة لدينا.

التسعير

نفس رصيد التطبيق. $1 = 100 رصيد، مع مكافآت الحجم الموجودة على عمليات التعبئة. تكلّف الأغنية من 60 ثانية 60 رصيداً ($0.60). أفاتار الرأس المتكلم لمدة 30 ثانية يكلف 450 رصيداً في المستوى المتوازن. ترجمة فيديو لمدة دقيقة واحدة بالمستوى المميز تكلّف ما يقارب 190 رصيداً. مفاتيح بيئة التجربة مجانية.

خطط API متدرجة (Pro وBusiness وEnterprise) بخصومات على الأسعار الجملية وعمال ذوي أولوية قادمة قريباً. إن كنت تحتاجها اليوم، اترك بريدك الإلكتروني على /contact?topic=api-tiers وسنبلّغك فور إطلاقها.

جرّبها الآن

• /api — عرض تعريفي في خمس دقائق
• /api/docs — المرجع التقني (المصادقة، الاتساق، الـ webhooks، بيئة التجربة، الأخطاء، الـ SDKs)
• /api/status — الحالة الحية للخدمات
• /api/changelog — ما تم إطلاقه وما هو قادم
• /dashboard/api-keys — أنشئ مفتاحك الأول

للإبلاغ عن أخطاء أو طلب ميزات: GitHub Issues. لأي شيء آخر: support@clipmixai.com.