API ডকুমেন্টেশন

DeepManim পাবলিক API v1

শুরু করুন

DeepManim API প্রোগ্রাম থেকেই শিক্ষামূলক অ্যানিমেশন ভিডিও তৈরি করতে দেয়। টেক্সট প্রম্পট থেকে ভিডিও তৈরি, ধাপে ধাপে উন্নত করা এবং বর্ণনা যোগ—সবই সহজ REST API দিয়ে করুন।

বেস URL: 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": "bn"}'

২. সম্পূর্ণ হওয়া পর্যন্ত দেখুন

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

৩. ফলাফল নিন

# status: "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 ক্রেডিট

তৈরি ও উন্নত করার খরচ নির্বাচিত প্রিসেটের ওপর নির্ভর করে এবং বর্তমানে ১.৫ থেকে ৭০ ক্রেডিট। সেশন, বার্তা, কাজের অবস্থা ও অ্যাকাউন্ট তথ্য পড়া বিনামূল্যে।

ত্রুটির প্রতিক্রিয়া

স্ট্যাটাসঅর্থ
401API কী অনুপস্থিত বা অবৈধ
402পর্যাপ্ত ক্রেডিট নেই
404রিসোর্স পাওয়া যায়নি (সেশন, বার্তা বা কাজ)
400অনুরোধ অবৈধ (যেমন উন্নত করার ভিডিও নেই বা পরিমার্জনের বর্ণনা নেই)
API ডকুমেন্টেশন | DeepManim