डॉक्स देखें

Public API गाइड

Public API क्विक स्टार्ट

Kritiverse API से अपने कोड से पहली इमेज बनाएँ: key बनाएँ, एक request भेजें और नतीजा पढ़ें।

यह पेज आपको बिना key से शुरू करके Public API से पहले नतीजे तक ले जाता है।

यह क्या करता है

API से आपका अपना ऐप, शॉप या script आपके Kritiverse अकाउंट पर इमेज, वीडियो, voice over और UGC ad बना सकता है। यह वेबसाइट वाले ही टूल इस्तेमाल करता है, उसी दाम पर और उन्हीं सेफ्टी नियमों के साथ। हर नतीजा आपकी Library में भी आ जाता है।

Free प्लान: शामिल नहीं। Pro प्लान: शामिल।

कब इस्तेमाल करें

  • आप अपने सिस्टम से अपनी शॉप के हर प्रोडक्ट की तस्वीरें बनवाना चाहते हैं।
  • आप एजेंसी चलाते हैं और नतीजे सीधे अपने वर्कफ़्लो में चाहते हैं।
  • किसी दूसरे ऐप में कुछ होने पर आप चाहते हैं कि job अपने आप शुरू हो जाए।

एक बार के काम के लिए वेबसाइट ज़्यादा तेज़ है।

स्टेप बाय स्टेप

  1. My account खोलें, फिर API टैब।
  2. Create key दबाएँ। उसे एक नाम दें और सिर्फ़ वही चीज़ें चुनें जो इस key को चाहिए।
  3. अपने साइन इन चेक से पुष्टि करें। हर बार key बनाते समय आपका अकाउंट यह माँगता है।
  4. key कॉपी करें। वह kvk_ से शुरू होती है और सिर्फ़ एक बार दिखती है।
  5. अपनी पहली request भेजें:
curl https://kritiverse.com/api/public/v1/images \
  -H "Authorization: Bearer kvk_your_key" \
  -H "Idempotency-Key: my-first-image-001" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cup of masala chai on a brass tray, morning light", "ratio": "1:1"}'
  1. जवाब में आपको एक job id मिलेगा। job को तब तक पढ़ते रहें जब तक उसका status done न हो जाए:
curl https://kritiverse.com/api/public/v1/jobs/JOB_ID \
  -H "Authorization: Bearer kvk_your_key"
  1. हर asset के file पते से वही key लगाकर तस्वीर Download करें।

key अपने सर्वर पर ही रखें। उसे कभी वेब पेज या फ़ोन ऐप में न डालें, वहाँ कोई भी उसे पढ़ सकता है।

हर विकल्प की जानकारी

key क्या-क्या कर सकती है

Scopeक्या करने देता है
images.writeइमेज बनाना
videos.writeवीडियो बनाना
voice.writevoice over बनाना और voices की लिस्ट देखना
ugc.writeUGC ad बनाना
captions.writeक्लिप से captions बनाना
recreate.writeReCreate इस्तेमाल करना
hdr.writeHDR Processing इस्तेमाल करना
avatar.writeavatar वीडियो बनाना
influencer.writeAI Influencer वीडियो बनाना
jobs.readjob पढ़ना
assets.readफ़ाइलें पढ़ना और Download करना
assets.writeतस्वीरें Upload करना
balance.readअपने Credits देखना

हर key को सिर्फ़ उतना ही दें जितना उसे चाहिए। अगर आप हर ऐप के लिए अलग key रखते हैं, तो बाकी को छुए बिना एक को बंद कर सकते हैं।

key की सीमाएँ

हर key की एक मिनट में request की सीमा होती है, और एक दिन और एक महीने में खर्च की सीमा Credits में होती है। key बनाते समय आप इन्हें तय करते हैं, और बाद में बदल भी सकते हैं। नई key एक सीमा के साथ शुरू होती है, ताकि आपके कोड की किसी गलती से आपका बैलेंस खाली न हो जाए।

key को बंद करना

API टैब में Revoke दबाएँ। key उसी समय बंद हो जाती है। हर जगह से साइन आउट करने से key बंद नहीं होती, इसलिए अगर key लीक हुई हो सकती है तो उसे खुद Revoke करें।

आम दिक्कतें

मुझे key_missing मिल रहा है

request में Authorization header नहीं है। उसमें पहले Bearer और फिर key लिखी होनी चाहिए।

मुझे plan_required मिल रहा है

इस key वाला अकाउंट ऐसे प्लान पर नहीं है जिसमें API हो। देखें प्लान।

मेरी key खो गई

key को दोबारा नहीं दिखाया जा सकता। उसे Revoke करें और नई key बनाएँ।

इससे जुड़ी गाइड

1 नव॰ 2026 को अपडेट हुआ