Public API क्विक स्टार्ट
Kritiverse API से अपने कोड से पहली इमेज बनाएँ: key बनाएँ, एक request भेजें और नतीजा पढ़ें।
यह पेज आपको बिना key से शुरू करके Public API से पहले नतीजे तक ले जाता है।
यह क्या करता है
API से आपका अपना ऐप, शॉप या script आपके Kritiverse अकाउंट पर इमेज, वीडियो, voice over और UGC ad बना सकता है। यह वेबसाइट वाले ही टूल इस्तेमाल करता है, उसी दाम पर और उन्हीं सेफ्टी नियमों के साथ। हर नतीजा आपकी Library में भी आ जाता है।
Free प्लान: शामिल नहीं। Pro प्लान: शामिल।
कब इस्तेमाल करें
- आप अपने सिस्टम से अपनी शॉप के हर प्रोडक्ट की तस्वीरें बनवाना चाहते हैं।
- आप एजेंसी चलाते हैं और नतीजे सीधे अपने वर्कफ़्लो में चाहते हैं।
- किसी दूसरे ऐप में कुछ होने पर आप चाहते हैं कि job अपने आप शुरू हो जाए।
एक बार के काम के लिए वेबसाइट ज़्यादा तेज़ है।
स्टेप बाय स्टेप
- My account खोलें, फिर API टैब।
- Create key दबाएँ। उसे एक नाम दें और सिर्फ़ वही चीज़ें चुनें जो इस key को चाहिए।
- अपने साइन इन चेक से पुष्टि करें। हर बार key बनाते समय आपका अकाउंट यह माँगता है।
- key कॉपी करें। वह
kvk_से शुरू होती है और सिर्फ़ एक बार दिखती है। - अपनी पहली 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"}'
- जवाब में आपको एक job id मिलेगा। job को तब तक पढ़ते रहें जब तक उसका status
doneन हो जाए:
curl https://kritiverse.com/api/public/v1/jobs/JOB_ID \
-H "Authorization: Bearer kvk_your_key"
- हर asset के
fileपते से वही key लगाकर तस्वीर Download करें।
key अपने सर्वर पर ही रखें। उसे कभी वेब पेज या फ़ोन ऐप में न डालें, वहाँ कोई भी उसे पढ़ सकता है।
हर विकल्प की जानकारी
key क्या-क्या कर सकती है
| Scope | क्या करने देता है |
|---|---|
images.write | इमेज बनाना |
videos.write | वीडियो बनाना |
voice.write | voice over बनाना और voices की लिस्ट देखना |
ugc.write | UGC ad बनाना |
captions.write | क्लिप से captions बनाना |
recreate.write | ReCreate इस्तेमाल करना |
hdr.write | HDR Processing इस्तेमाल करना |
avatar.write | avatar वीडियो बनाना |
influencer.write | AI Influencer वीडियो बनाना |
jobs.read | job पढ़ना |
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 बनाएँ।
इससे जुड़ी गाइड
- इमेज, वीडियो, Voice और UGC Ad बनाएँAPI से इमेज, वीडियो, voice over और UGC ad बनाने के सारे फ़ील्ड, और पहले खर्च कैसे देखें।
- Jobs, Assets और आपका बैलेंसAPI से job का status पढ़ें, नतीजे Download करें, अपनी तस्वीरें Upload करें और अपने Credits देखें।
- API की Errors और सीमाएँAPI जो भी error code दे सकती है, उसका मतलब, और request और Credits की सीमाएँ।
1 नव॰ 2026 को अपडेट हुआ