API دستاویزات

DeepManim عوامی API v1

آغاز

DeepManim عوامی API آپ کو پروگرام کے ذریعے تعلیمی اینیمیشن ویڈیوز بنانے دیتی ہے۔ ٹیکسٹ پرامپٹس سے ویڈیوز بنائیں، انہیں مرحلہ وار بہتر کریں اور وائس اوور شامل کریں — سب کچھ سادہ REST API کے ذریعے۔

بنیادی URL: https://api.deepmanim.com/api/v1

اہم نوٹس

  • تخلیق کے وقت آڈیو: جب آپ /generate کے ذریعے نئی ویڈیو بناتے ہیں تو وائس اوور ڈیفالٹ طور پر شامل ہوتا ہے۔
  • ترمیم پر آڈیو نہیں: جب آپ /improve کے ذریعے ویڈیو بہتر کرتے ہیں تو نتیجے میں آڈیو شامل نہیں ہوتا۔ تمام ترامیم پہلے مکمل کریں، پھر اطمینان ہونے پر /audio کے ذریعے ایک بار آڈیو شامل کریں۔
  • متوقع وقت: ویڈیو بنانے میں تقریباً 6 منٹ لگتے ہیں۔ جاب کے جواب میں estimated_time_remaining_seconds فیلڈ براہِ راست الٹی گنتی دیتی ہے۔

تصدیق

تمام API درخواستوں کے لیے 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": "ur"}'

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 کریڈٹس تک ہے۔ سیشنز، پیغامات، جاب کی حالت اور اکاؤنٹ کی معلومات پڑھنا مفت ہے اور کریڈٹس نہیں گھٹاتا۔

خرابی کے جوابات

حالتمطلب
401API کی غائب یا غیر درست
402کریڈٹس ناکافی ہیں
404وسیلہ نہیں ملا (سیشن، پیغام یا جاب)
400غیر درست درخواست (مثلاً بہتر کرنے کے لیے ویڈیو یا نکھارنے کے لیے وائس اوور نہیں)
API دستاویزات | DeepManim