البدء
يتيح لك DeepManim API توليد فيديوهات تعليمية متحركة برمجيًا. أنشئ فيديوهات من طلبات نصية، وحسّنها تدريجيًا، وأضف تعليقًا صوتيًا — كل ذلك عبر REST API بسيطة.
عنوان URL الأساسي: https://api.deepmanim.com/api/v1
ملاحظات مهمة
- الصوت عند التوليد: عند توليد فيديو جديد عبر /generate، يُضمّن التعليق الصوتي افتراضيًا.
- لا صوت عند التعديلات: عند تحسين فيديو عبر /improve، لا تتضمن النتيجة صوتًا. أنهِ جميع تعديلاتك أولًا، ثم أضف الصوت عبر /audio بعد رضاك عن الفيديو.
- الأوقات المقدّرة: يستغرق توليد الفيديو نحو 6 دقائق. يعرض الحقل estimated_time_remaining_seconds في استجابة المهمة عدًّا تنازليًا مباشرًا.
المصادقة
تتطلب جميع طلبات API مفتاح API. أنشئ واحدًا من الإعدادات ← مفاتيح API في التطبيق.
يتطلب شراء أرصدة. يتاح الوصول إلى API للمستخدمين الذين اشتروا أرصدة مرة واحدة على الأقل. لا تكفي أرصدة المستوى المجاني وحدها.
أدرج مفتاحك في ترويسة Authorization:
Authorization: Bearer dm_k_your_api_key_here
حافظ على سرية مفتاح API. لا تشاركه في مستودعات عامة أو تطبيقات من جهة العميل.
بدء سريع
ولّد فيديو في ثلاث خطوات: أنشئ مهمة، واستعلم عن اكتمالها، ثم استرجع النتيجة.
1. توليد فيديو
curl -X POST https://api.deepmanim.com/api/v1/generate \
-H "Authorization: Bearer dm_k_your_key" \
-H "Content-Type: application/json" \
-d '{"message": "اشرح كيف تعمل عملية البناء الضوئي", "preferred_locale": "ar"}'2. الاستعلام عن الاكتمال
curl https://api.deepmanim.com/api/v1/jobs/JOB_ID \ -H "Authorization: Bearer dm_k_your_key" # تتضمن الاستجابة: # status: "pending" | "running" | "completed" | "failed" # phase: "exploring_ideas" | "brainstorming" | "crafting_vision" | "refining_details" | "assembling_pieces" | "polishing" | "adding_voice" | "iterating" | "done" # estimated_time_remaining_seconds: 285
3. الحصول على النتيجة
# عند اكتمال الحالة "completed":
{
"job_id": "...",
"status": "completed",
"phase": "done",
"estimated_time_remaining_seconds": 0,
"result": {
"video_url": "https://...",
"description": "رسوم متحركة تشرح عملية البناء الضوئي...",
"session_id": "...",
"message_id": "...",
"duration_seconds": 24.6,
"has_audio": true,
"follow_up": "ما علاقة التنفس الخلوي بالبناء الضوئي؟"
}
}نقاط النهاية
توليد الفيديو
المهام
الجلسات
الرسائل
الحساب
الأرصدة والأسعار
يخصم كل استدعاء API ينشئ مهمة أرصدة من رصيدك:
| العملية | التكلفة |
|---|---|
| توليد فيديو | يبدأ من 1.5 رصيد |
| تحسين فيديو | يبدأ من 1.5 رصيد |
| إضافة صوت | 1 رصيد |
| تحسين التعليق الصوتي | 1 رصيد |
تعتمد تكلفة التوليد والتحسين على الإعداد المسبق المحدد، وتتراوح حاليًا بين 1.5 و70 رصيدًا. قراءة الجلسات والرسائل وحالة المهام ومعلومات الحساب مجانية ولا تخصم أرصدة.
استجابات الخطأ
| الحالة | المعنى |
|---|---|
| 401 | مفتاح API مفقود أو غير صالح |
| 402 | أرصدة غير كافية |
| 404 | المورد غير موجود (جلسة أو رسالة أو مهمة) |
| 400 | طلب غير صالح (مثل عدم وجود فيديو لتحسينه أو تعليق صوتي لصقله) |