इमेज, वीडियो, Voice और UGC Ad बनाएँ

API से इमेज, वीडियो, voice over और UGC ad बनाने के सारे फ़ील्ड, और पहले खर्च कैसे देखें।

यह पेज बताता है कि Public API से आप किस-किस तरह की job शुरू कर सकते हैं और हर job में कौन-से फ़ील्ड लगते हैं।

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

job यानी काम का एक टुकड़ा। आप request भेजते हैं, और काम चलते समय जवाब में तुरंत एक job id आ जाता है। नतीजा बाद में आता है: job को पढ़ें, या webhook इस्तेमाल करें।

कुछ भी बनाने वाली हर call में Idempotency-Key header चाहिए। अगर आपका नेटवर्क टूट जाए और आप वही request उसी key से दोबारा भेजें, तो आपको पहला ही जवाब मिलता है और पैसे सिर्फ़ एक बार कटते हैं। 8 से 80 अक्षर, अंक, हाइफ़न या अंडरस्कोर में से कुछ भी इस्तेमाल करें। वही key 24 घंटे बाद दोबारा इस्तेमाल हो सकती है।

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

POST /quote से दाम पूछें। यह मुफ़्त है और कुछ भी होल्ड नहीं करता।
उस job की अपनी call से job शुरू करें।

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

पहले दाम पूछें

POST /api/public/v1/quote में type (image, video, voice या ugc) और उस job के फ़ील्ड भेजे जाते हैं।

इमेज

POST /api/public/v1/images

फ़ील्ड	मतलब
`prompt`	क्या बनाना है, ज़्यादा से ज़्यादा 2,000 अक्षर
`ratio`	`1:1`, `4:5`, `3:2`, `16:9` या `9:16`
`count`	कितनी, 1 से 4
`tier`	`auto`, `flash`, `studio` या `pro`। Auto आपके लिए खुद चुनता है।
`references`	लुक या लेआउट के लिए ज़्यादा से ज़्यादा 3 asset id
`people`	उसी व्यक्ति को बनाए रखने के लिए ज़्यादा से ज़्यादा 4 asset id
`products`	उसी प्रोडक्ट को बनाए रखने के लिए ज़्यादा से ज़्यादा 4 asset id

request में तस्वीर होने पर job ऐसे tier पर चली जाती है जो तस्वीरें पढ़ सकता है, इसलिए quote आपको असली दाम बता देता है।

वीडियो

POST /api/public/v1/videos

फ़ील्ड	मतलब
`prompt`	वीडियो में क्या होता है
`ratio`	`9:16`, `16:9`, `1:1` या `auto`। `start_frame` या `end_frame` के साथ ratio न दें तो `auto` लगता है: वीडियो फ़्रेम का आकार लेता है, tier का सबसे नज़दीकी आकार
`seconds`	लंबाई। हर tier सिर्फ़ कुछ तय लंबाइयाँ बनाता है, और सबसे पास वाली इस्तेमाल होती है।
`tier`	`auto`, `motion` या `cinema`
`start_frame`	पहले फ़्रेम के लिए asset id
`end_frame`	आखिरी फ़्रेम के लिए asset id

Voice over

POST /api/public/v1/voice

फ़ील्ड	मतलब
`text`	क्या बोलना है
`voice`	`GET /voices` से मिला voice id। अपनी default आवाज़ के लिए इसे छोड़ दें।
`language`	`hi` या `en` जैसा भाषा कोड, या `auto`
`level`	`standard` या `studio`

GET /api/public/v1/voices से voices की लिस्ट मिलती है। हिंदी voices देखने के लिए ?lang=hi जोड़ें।

पूरी हुई voice job में files होता है, जिसमें हर फ़ॉर्मेट का एक पता रहता है।

UGC ad

POST /api/public/v1/ugc

फ़ील्ड	मतलब
`product`	प्रोडक्ट की साफ़ फ़ोटो का asset id। ज़रूरी है।
`prompt`	जो कुछ भी आप जोड़ना चाहें, अपने शब्दों में
`mode`	`image` या `video`
`takes`	इमेज के लिए, कितने अलग-अलग take, 1 से 3। हर take अपनी अलग job है, और उसका अपना चार्ज लगता है। Credits कम पड़ें तो कम jobs बनती हैं, और `jobs` में वही दिखती हैं।
`category`	प्रोडक्ट category का कोड, जैसे `SKIN` या `FOOD`

अपनी तस्वीरें इस्तेमाल करना

पहले तस्वीर Upload करें और ऊपर के फ़ील्ड में उसका asset id लगाएँ। देखें Jobs और assets।

आम दिक्कतें

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

वेबसाइट वाले ही सेफ्टी नियम यहाँ भी लगते हैं। कुछ भी चार्ज नहीं होता। request बदलें।

मेरी तस्वीर प्रोडक्ट से अलग बनी

प्रोडक्ट को products में भेजें, साफ़ और अच्छी रोशनी वाली फ़ोटो के साथ।

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

यह job इस key की सीमा पार कर देती। जवाब बताता है कि कौन-सी सीमा है और कितना इस्तेमाल हो चुका है। API टैब में सीमा बढ़ाएँ, या अगले दिन या महीने का इंतज़ार करें।

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

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