وثائق API

واجهة DeepManim العامة — الإصدار v1

البدء

يتيح لك 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طلب غير صالح (مثل عدم وجود فيديو لتحسينه أو تعليق صوتي لصقله)
وثائق API | DeepManim