مستندات API DeepManim

API عمومی DeepManim نسخه ۱

شروع کار

API DeepManim به شما امکان می‌دهد ویدئوهای آموزشی متحرک را با کد تولید کنید. از درخواست متنی ویدئو بسازید، آن را مرحله‌به‌مرحله بهبود دهید و روایت اضافه کنید؛ همه با یک REST API ساده.

نشانی پایه: https://api.deepmanim.com/api/v1

نکته‌های مهم

  • صوت هنگام تولید: هنگام ساخت ویدئوی جدید با /generate، روایت صوتی به‌صورت پیش‌فرض اضافه می‌شود.
  • بدون صوت هنگام اصلاح: نسخه‌ای که با /improve بهبود می‌دهید صوت ندارد. همه اصلاحات را اول تمام کنید و سپس با /audio صوت را اضافه کنید.
  • زمان تقریبی: تولید ویدئو حدود ۶ دقیقه طول می‌کشد. فیلد estimated_time_remaining_seconds در پاسخ کار شمارش معکوس زنده را نشان می‌دهد.

احراز هویت

همه درخواست‌های API به کلید API نیاز دارند. آن را از بخش تنظیمات → کلیدهای API در برنامه بسازید.

خرید اعتبار لازم است. دسترسی API برای کاربرانی فعال است که دست‌کم یک‌بار اعتبار خریده باشند؛ اعتبار رایگان به‌تنهایی کافی نیست.

کلید خود را در سرآیند Authorization قرار دهید:

Authorization: Bearer dm_k_your_api_key_here

کلید API را محرمانه نگه دارید. آن را در مخزن عمومی یا برنامه سمت کاربر به اشتراک نگذارید.

شروع سریع

در سه گام ویدئو بسازید: کار را ایجاد کنید، تا پایان بررسی کنید و نتیجه را دریافت کنید.

۱. تولید ویدئو

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": "fa"}'

۲. بررسی تا پایان

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

۳. دریافت نتیجه

# وقتی وضعیت 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 اعتبار
بهبود روایت1 اعتبار

هزینه تولید و بهبود به پیش‌تنظیم انتخاب‌شده بستگی دارد و فعلاً بین ۱٫۵ تا ۷۰ اعتبار است. خواندن جلسه‌ها، پیام‌ها، وضعیت کار و اطلاعات حساب رایگان است و اعتبار مصرف نمی‌کند.

پاسخ‌های خطا

وضعیتمعنا
401کلید API وجود ندارد یا نامعتبر است
402اعتبار کافی نیست
404منبع پیدا نشد (جلسه، پیام یا کار)
400درخواست نامعتبر (برای نمونه، ویدئویی برای بهبود یا روایتی برای اصلاح وجود ندارد)
مستندات API DeepManim | DeepManim