API · v1 · متاح الآن

ضاعف إنتاجك الإبداعي
مع AdsTurbo API

ادمج واجهات AdsTurbo API — من الرابط إلى فيديو، وتوليد الصور، و Persona، والممثلون بالذكاء الاصطناعي، واستنساخ الإعلانات، وتوليد الفيديو، والمهام — مباشرةً في منصتك، ووسّع إنتاج الإعلانات برمجيًا.

توثيق API
تستخدم ChatGPT أو Claude أو Cursor؟ اتصل عبر MCP ←
24نقطة نهاية API
غير متزامنتتبّع المهام
RESTبروتوكول قياسي
ابدأ الإنشاء مع AdsTurbo API اليوم

مكوّنات معيارية
لإنتاج إعلانات قابل للبرمجة.

سبع وحدات API قابلة للتركيب. طبقة واحدة للبنية الإبداعية.

POST /url2video/createمن رابط إلى فيديو

من رابط إلى فيديو

أرسل رابط صفحة المنتج واحصل على إعلان فيديو مدته 15 ثانية. طلب واحد ينجز العمل كله: تقرأ الواجهة صفحة المنتج، وتخطط للإعلان، وتُخرج الفيديو بنسبة 9:16 أو 1:1 أو 16:9 وبدقة 720p. وإذا تعذّرت قراءة الصفحة، مرّر تفاصيل المنتج (العنوان، الوصف، السعر، الصور) بدلًا من الرابط. متاحة أيضًا كأداة create_ad_from_product_url على خادم AdsTurbo MCP المستضاف.

عرض التوثيق
POST /img/createتوليد الصور

توليد الصور

تحويل النص إلى صورة وتحرير الصور. يدعم 11 نموذجًا (nanobanana-pro / seedream-4.5 / gpt-image-1.5 / gpt-image-2 / grok-2-image وغيرها)، مع إمكانية ضبط نسبة الأبعاد والدقة وعدد المهام المتزامنة.

عرض التوثيق
POST /persona/createPersona

Persona

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

عرض التوثيق
POST /aiactor/list · /aiactor/say · /aiactor/performممثلون بالذكاء الاصطناعي

ممثلون بالذكاء الاصطناعي

ابحث في مكتبة ممثلي النظام، وولّد المقاطع الصوتية، وحرّك الممثلين أو Persona المخصصة عبر نص مكتوب. يدعم إعادة استخدام Persona التي أُنشئت سابقًا مباشرةً.

عرض التوثيق
POST /adclone/analyze · /adclone/generateاستنساخ الإعلانات

استنساخ الإعلانات

سير عمل للاستنساخ من خطوتين: حلّل مقطعًا مرجعيًا (12 ثانية كحد أقصى) لاستخراج الأسلوب والبنية، ثم ولّد بالتوازي نسخًا إعلانية متوافقة مع علامتك التجارية.

عرض التوثيق
POST /video/analyze · /lipsync · /inpaint · ...توليد الفيديو

توليد الفيديو

ثماني نقاط نهاية لمعالجة الفيديو: تحليل اللقطات، ومزامنة الشفاه، وإزالة العلامة المائية، والترجمة، ورفع الدقة، وتبديل الوجه، والتحكم في الحركة، والترجمة النصية.

عرض التوثيق
POST /work/statusالمهام

المهام

جميع مهام التوليد غير متزامنة. استعلم دوريًا عن حالة المهمة أو استقبل أحداث الاكتمال عبر Webhook.

عرض التوثيق

تفضّل المحادثة على كتابة الكود؟ استخدم AdsTurbo عبر MCP.

الإمكانات نفسها التي يوفرها API، داخل ChatGPT و Claude و Cursor و WorkBuddy مباشرةً. سجّل الدخول مرة واحدة، دون أي كود.

إعداد MCP
أبرز حالات استخدام AdsTurbo API

أتمتة إعلانية قوية
في مختلف القطاعات.

مصمَّمة للفرق التي تحتاج إلى طاقة إنتاج إبداعي عالية، لا مجرد توليد محتوى.

توليد الصور

إنتاج صور الإعلانات بالجملة

ولّد صورًا إعلانية جاهزة لعلامتك التجارية على نطاق واسع عبر واجهة توليد الصور. تدعم وضعَي تحويل النص إلى صورة وتحرير الصور، مع مجموعة من أبرز النماذج وتحكم مرن في نسبة الأبعاد والدقة وعدد المهام المتزامنة. مثالية لعلامات البيع المباشر للمستهلك (DTC) وفرق التجارة الإلكترونية ومنصات الإعلانات التي تحتاج إلى إنتاج إبداعي بكميات كبيرة.

إنتاج صور الإعلانات بالجملة
استنساخ الإعلانات

توليد المواد الإعلانية تلقائيًا

حوّل أصول المنتج والمقاطع المرجعية الناجحة إلى مواد إعلانية جاهزة لعلامتك التجارية. أنشئ ممثلين افتراضيين قابلين لإعادة الاستخدام عبر واجهة Persona، ثم استخدم واجهة استنساخ الإعلانات لتحليل أسلوب الفيديو المرجعي وبنيته وتوليد عدة نسخ إعلانية بالتوازي. مصمَّمة لمنصات SaaS الإبداعية وعلامات DTC وفرق أتمتة النمو.

توليد المواد الإعلانية تلقائيًا
ممثلون بالذكاء الاصطناعي

تسويق بالفيديو عبر ممثلي الذكاء الاصطناعي على نطاق واسع

اختر من مكتبة ممثلي النظام أو استخدم Persona مخصصة، ثم حرّكهم عبر نص مكتوب لإنتاج أداء بالفيديو. يمكن أيضًا توليد الصوت بشكل مستقل لسير عمل الدبلجة. يدعم تحكمًا دقيقًا في الانفعال والسرعة ونبرة الصوت — مثالي لإنتاج المحتوى المحلي وفيديوهات المبيعات وسرد قصة العلامة التجارية.

تسويق بالفيديو عبر ممثلي الذكاء الاصطناعي على نطاق واسع
المهام

تنسيق إبداعي بمستوى المنصات

اربط خلاصات المنتجات والمدخلات الإبداعية وعمليات الحملات في طبقة واحدة قابلة للبرمجة لإنتاج الإعلانات. تعمل جميع مهام التوليد بشكل غير متزامن، مع دعم الاستعلام الدوري عن حالة المهمة واستقبال إشعارات Webhook — ما يجعل دمجها في سير العمل المؤتمت أمرًا سهلًا. مصمَّمة لمساحات عمل الوكالات ومنصات أتمتة النمو.

تنسيق إبداعي بمستوى المنصات
توليد الفيديو

التكامل مع منصات صنّاع المحتوى

حوّل ملامح صانع المحتوى وصوته وسياق العلامة التجارية إلى أصول قابلة لإعادة الاستخدام في إنتاج الإعلانات. تدعم وحدة توليد الفيديو الترجمة مع الدبلجة، ومزامنة الشفاه، والتحكم في الحركة وغيرها — ما يتيح تكييف المادة الأصلية نفسها بسرعة مع لغات وأساليب مختلفة، وتلبية احتياجات توزيع المحتوى في أسواق متعددة.

التكامل مع منصات صنّاع المحتوى
تكامل المطوّرين

واجهة REST API بسيطة.
جاهزة للإنتاج من اليوم الأول.

مصادقة Bearer، واستدعاءات راجعة ملائمة للعمل غير المتزامن، ونقاط نهاية قابلة للتركيب. تكامل مباشر وسهل.

curl --request POST \
  --url https://adsturbo.ai/klian/novartapi/openapi/v1/img/create \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --data '{
    "prompt": "Asian woman, home setting, natural light, commercial ad style",
    "image_urls": [],
    "model": "nanobanana-pro",
    "ratio": "9:16",
    "resolution": "2k",
    "concurrency": 1,
    "sync_mod": false
  }'

مصادقة Bearer

مصادقة REST قياسية باستخدام مفتاح API. مرّر مفتاحك في ترويسة Authorization بالصيغة Bearer YOUR_API_KEY.

تتبّع المهام غير المتزامنة

جميع مهام التوليد غير متزامنة. استعلم دوريًا عن حالة المهمة أو استقبل أحداث الاكتمال عبر Webhook.

إشعارات Webhook

استقبل أحداث اكتمال المهام فور انتهاء التوليد. اضبط عنوان Webhook في لوحة التحكم، وأضف معرّفًا مخصصًا إلى طلباتك لربط الأحداث بمهام محددة.

الأسئلة الشائعة

01ما هو AdsTurbo API؟

AdsTurbo API طبقة بنية إبداعية قابلة للبرمجة تتيح لك تضمين توليد الإعلانات وإنشاء Persona وسير عمل الإنتاج غير المتزامن مباشرةً في منتجك أو منصتك.

02هل يمكنني تحويل رابط صفحة منتج إلى إعلان فيديو عبر API؟

نعم. استدعِ POST /openapi/v1/url2video/create مع {"product_url": "<your product page>"}. تُرجع الواجهة work_id؛ استعلم دوريًا عبر POST /openapi/v1/work/status حتى تكتمل المهمة، ثم نزّل الفيديو من result_url. مدة الفيديو 15 ثانية، بنسبة 9:16 أو 1:1 أو 16:9 وبدقة 720p، وتكلفة كل فيديو 270 نقطة. وإذا كانت صفحة المنتج تتطلب تسجيل الدخول أو تعذّرت قراءتها، أرسل كائن product (title، description، price، images، brand) مع ad_type بدلًا من الرابط. وفي Claude Code أو Cursor أو أي عميل MCP، أضف خادم AdsTurbo MCP المستضاف واستدعِ الأداة create_ad_from_product_url.

03لمن صُمّم AdsTurbo API؟

صُمّم لمنصات SaaS الإبداعية ومساحات عمل الوكالات وفرق أتمتة النمو ومنصات صنّاع المحتوى التي تحتاج إلى إنتاج مواد إعلانية تحمل هوية العلامة التجارية على نطاق واسع.

04كيف تعمل واجهة Persona؟

ارفع صورة وعيّنة صوتية اختيارية لإنشاء ممثل افتراضي قابل لإعادة الاستخدام (Persona). بعد إنشائها يمكن استخدام Persona مرارًا في أداء الممثلين بالذكاء الاصطناعي واستنساخ الإعلانات وغيرها من مسارات التوليد. وتتوفر إدارة كاملة لدورة الحياة: الإنشاء، والاستعلام عن الحالة، وعرض القائمة، والحذف.

05ما النماذج التي تدعمها واجهة توليد الصور (/img/create)؟

تدعم 11 نموذجًا: nanobanana-pro (الافتراضي)، nano-banana-2، nano-banana-2-fast، seedream-4.5، seedream-4.5-seq، seedream-5.0-lite، seedream-5.0-lite-seq، gpt-image-1.5، gpt-image-2، grok-2-image، grok-imagine-image. ويتوفر وضعا تحويل النص إلى صورة وتحرير الصور.

06هل يتوفر تتبّع للمهام غير المتزامنة؟

نعم. تعمل جميع مهام التوليد بشكل غير متزامن. يمكنك الاستعلام دوريًا عن حالة المهمة أو إعداد Webhook لتلقّي إشعار تلقائي عند اكتمالها، ما يسهّل دمجها في سير العمل المؤتمت.

07هل يوجد حد لطول مقطع الفيديو في استنساخ الإعلانات؟

نعم. استنساخ الإعلانات سير عمل من خطوتين: أولًا حلّل مقطع فيديو مرجعيًا (12 ثانية كحد أقصى) لاستخراج أسلوبه وبنيته، ثم ولّد نسخًا إعلانية بناءً على نتيجة التحليل. ويُدعم توليد عدة نسخ بالتوازي، ما يسهّل إنتاج محتوى إبداعي متنوع بسرعة.

08كيف أُعدّ إشعارات Webhook؟

اضبط نقطة نهاية Webhook في لوحة تحكم AdsTurbo. وعند إرسال طلبات API، أضف معرّفًا مخصصًا؛ فعند اكتمال مهمة التوليد يرسل النظام النتيجة تلقائيًا إلى عنوان Webhook مع ذلك المعرّف، لتتمكن من ربطها بالمهمة المحددة.

09ما الذي تدعمه واجهة توليد الفيديو؟

توفر وحدة توليد الفيديو 8 إمكانات: تحليل اللقطات، ومزامنة الشفاه، وإزالة العلامة المائية، وترجمة الفيديو مع الدبلجة، ورفع دقة الفيديو، وتبديل الوجه، والتحكم في الحركة، وتوليد الترجمة النصية. مناسبة لتوطين المحتوى وتكييف المواد الإبداعية وسير عمل ما بعد الإنتاج.

10كيف تُحتسب الأسعار؟

تعتمد الأسعار على حجم استخدام API. تواصل مع فريق AdsTurbo أو زر الموقع الرئيسي للحصول على مفتاح API ومناقشة شرائح الاستخدام.

11كيف أبدأ؟

احصل على مفتاح API من adsturbo.ai، واقرأ توثيق API على doc.adsturbo.ai، ثم نفّذ أول طلب إلى POST /img/create — يكفي أن تمرّر prompt لتحصل على صورة مولَّدة. إنها أبسط نقطة نهاية للبدء (لا تحتاج إلى أي إعداد سوى مفتاح API).

12هل يتوفر خادم MCP لمساعدي الذكاء الاصطناعي؟

نعم. يمنح خادم AdsTurbo MCP كلًّا من ChatGPT و Claude و Cursor و WorkBuddy وغيرها من عملاء MCP الإمكانات نفسها التي توفرها هذه الواجهة. سجّل الدخول عبر OAuth أو استخدم مفتاح API. دليل الإعداد: adsturbo.ai/mcp

راسلنا على support@adsturbo.ai لأي استفسار.

ابدأ البناء اليوم

اربط خط إنتاج إعلاناتك
بـ AdsTurbo API

احصل على مفتاح API ووسّع استخدامك متى كنت جاهزًا.

توثيق API
✓REST + جاهزية للعمل غير المتزامن✓مصادقة Bearer · طلب/استجابة بصيغة JSON✓دعم إشعارات Webhook