Leelo

للمطورين · API

كل ما يفعله Leelo، خلف مفتاح واحد.

الكلام والدبلجة والتفريغ والمؤثرات الصوتية والتنقية عبر واجهة REST بسيطة. تُخبرك Webhooks حين تنتهي المهام الطويلة، ويتيح خادم MCP لمساعدي الذكاء الاصطناعي استخدام Leelo مباشرةً.

احصل على مفتاح APIاطّلع على نقاط الوصول

API وWebhooks وMCP في خطتَي Pro وBusiness

API وMCP · 0:36

01نقاط الوصول

كل مسار، وتكلفته.

JSON يدخل وJSON يخرج، ومفتاح واحد لكل تطبيق في ترويسة Authorization. العنوان الأساسي: https://api.leelo-ai.com

المسارما يفعلهالرصيد
GET/v1/meخطتك، والرصيد المتبقي، والتخزينمجاني
GET/v1/voicesكل الأصوات، وأصواتك أولًا. ?locale=fr-FR و?q= و?limit= و?after=مجاني
GET/v1/voices/{id}صوت واحدمجاني
POST/v1/speechنص يُقرأ بصوت ← رابط إلى الملف الصوتي. والنص نفسه بالصوت نفسه مرة أخرى مجاني.1 للكلمة · 5 بصوتك الخاص
POST/v1/transcriptionsرابط وسائط ← أسطر بتوقيتاتها ومتحدثيها40 للدقيقة
GET/v1/transcriptions/{id}تفريغ أجريته من قبلمجاني
POST/v1/dubsرابط وسائط إلى لغة أخرى. يُعيد مهمة تكتمل من تلقاء نفسها.5,000 للدقيقة، لكل لغة
GET/v1/dubs/{id}أين وصلت الدبلجة، ورابطها حين تكتملمجاني
POST/v1/soundsوصف ← مؤثرات صوتية. ?attempts حتى 320 للثانية، وبحد أدنى 100
POST/v1/cleanupsرابط تسجيل ← الصوت وحده، بمستوى مضبوط1,300 للدقيقة
POST/v1/writingrewrite · shorten · fix · split · script · translate10 لكل 500 كلمة
GET/v1/projectsمشاريعك في الاستوديومجاني
GET/v1/projects/{id}أسطر المشروع ومتحدثوه وملفاته الصوتيةمجاني
POST/v1/projects/{id}/exportsالمشروع كاملًا في ملف واحد جاهزمجاني
GET/v1/filesالملفات المصدَّرة والدبلجات والتسجيلات المنقّاة والأصوات. ?kind=مجاني
GET/v1/usageكل عملية خصم، موسومة بالمفتاح الذي أجراهامجاني
GET/v1/ratesتكلفة كل شيء، بالرصيدمجاني
POST/v1/webhooksسجّل عنوانًا: { url, events }مجاني
GET/v1/webhooksWebhooks الخاصة بك، وكل الأحداث المتاحةمجاني
GET/v1/webhooks/deliveriesما أُرسل، وكيف جرىمجاني
DELETE/v1/webhooks/{id}إيقاف الإرسال إلى عنوانمجاني

02Webhooks

اعرف فور انتهائها.

سجّل عنوانًا والأحداث التي تهمك. كل إرسال موقَّع، ويُعاد إذا كان خادمك متوقفًا، ويُسجَّل لترى ما أُرسل.

  • dub.completedاكتملت دبلجة؛ ورابطها في الحمولة
  • dub.failedتعذّر إكمال دبلجة؛ وأُعيد رصيدها
  • transcription.completedالتفريغ جاهز
  • export.completedتصدير المشروع جاهز للتنزيل
  • credits.lowرصيد الشهر يوشك على النفاد
  • credits.depletedنفد رصيد الشهر

يحمل كل طلب Leelo-Signature: t=…,v1=…، وهو HMAC-SHA256 لـ`${t}.${body}` بالسر الخاص بـWebhook لديك. ويُعاد الإرسال الفاشل سبع مرات على مدى يوم ونصف.

import { createHmac, timingSafeEqual } from "node:crypto";

function verify(body, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const want = createHmac("sha256", secret).update(`${t}.${body}`).digest("hex");
  return timingSafeEqual(Buffer.from(want), Buffer.from(v1));
}

03MCP

Leelo داخل مساعدك الذكي.

اربط Claude أو Cursor أو أي عميل MCP، واطلب بكلمات بسيطة: اقرأ هذا بصوت بريطاني دافئ، أو دبلج هذا الفيديو إلى الإسبانية. يستخدم مفتاح API والرصيد نفسه، وتظهر كل عملية في سجل استخدامك.

Claude Code

claude mcp add --transport http leelo https://api.leelo-ai.com/mcp \
  --header "Authorization: Bearer lk_live_…"

Cursor وWindsurf وعملاء آخرون

{
  "mcpServers": {
    "leelo": {
      "url": "https://api.leelo-ai.com/mcp",
      "headers": { "Authorization": "Bearer lk_live_…" }
    }
  }
}

04مشغّل المقالات

«استمع إلى هذا المقال»، في سطر واحد.

انشر أي ملف مصدَّر بوصفه مشغّلًا بألوانك وبمظهر فاتح أو داكن، ثم الصق سطرًا واحدًا من HTML في صفحتك. متاح في كل الخطط، بلا حاجة إلى مفتاح API.

المظهر
لونك المميّز، فاتح أو داكن، مع شكل موجي وتحكم في السرعة.
الخفة
يُحمَّل عند الحاجة، ولا يُحمَّل الصوت إلا حين يضغط القارئ تشغيل.
الأرقام
تُحصى مرات التشغيل، ويصلك إشعار حين يتخطى المشغّل رقمًا مهمًا.
المقالات وسهولة الوصول ←
<iframe src="https://leelo-ai.com/embed/…"
  title="Listen: Why cities are getting quieter"
  width="100%" height="136" loading="lazy"
  style="border:0;max-width:760px;display:block"></iframe>

05أسئلة

قبل أن تبدأ البناء.

تأتي الواجهة البرمجية وWebhooks وخادم MCP مع خطتَي Pro وBusiness. أما مشغّل المقالات فيعمل في كل الخطط.

بالرصيد نفسه الذي في التطبيق، وبالأسعار نفسها: 1 رصيد للكلمة بصوت قياسي، و40 لدقيقة التفريغ، و5,000 لدقيقة الدبلجة لكل لغة. وطلب النص نفسه بالصوت نفسه مرة أخرى لا يكلّف شيئًا.

نعم. تظهر أصواتك المستنسخة والمصمَّمة أولًا في GET /v1/voices، وتكلّف 5 رصيد للكلمة.

الدبلجات مهام: يبدأ POST مهمة ويُعيد معرّفها. إما أن تسأل GET /v1/dubs/{id}، أو تسجّل Webhook فيصلك dub.completed مع رابط الملف.

نعم. يعرض GET /v1/usage كل عملية خصم موسومة بالمفتاح الذي أجراها، وتعرض صفحة الاستخدام في التطبيق المعلومات نفسها.

ابنِه مع Leelo.

ابدأ مجانًا، ثم انتقل إلى Pro حين تحتاج إلى مفتاح. الرصيد نفسه، والأصوات نفسها التي في التطبيق.

ابدأ مجانًا مع 1,000 رصيد