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 उन उपयोगकर्ताओं के लिए उपलब्ध है जिन्होंने कम-से-कम एक बार क्रेडिट खरीदे हैं। केवल मुफ़्त क्रेडिट पर्याप्त नहीं हैं।

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

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. परिणाम पाएँ

# पूरा होने पर:
{
  "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