API की Errors और सीमाएँ

API जो भी error code दे सकती है, उसका मतलब, और request और Credits की सीमाएँ।

यह पेज उन सारी errors को बताता है जो Public API दे सकती है, और key पर लगने वाली हर सीमा को भी।

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

error हमेशा इसी रूप में आती है, और code का मतलब कभी नहीं बदलता:

{ "error": { "code": "spend_cap_reached", "message": "...", "request_id": "...", "period": "day", "cap": 2000, "used": 1990, "need": 25 } }

अपना कोड code पर बनाएँ, message पर नहीं। सपोर्ट को लिखते समय request_id ज़रूर बताएँ।

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

जब कोई call फ़ेल हो तब यह पेज पढ़ें, और अपना कोड इस्तेमाल में लाने से पहले भी।

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

सीमाएँ

सीमा	मान
एक मिनट में requests	जो आपने key पर तय किया, ज़्यादा से ज़्यादा 120
एक दिन और एक महीने में खर्च	जो आपने key पर तय किया, Credits में। दिन और महीने भारतीय समय से चलते हैं।
Keys	एक अकाउंट पर ज़्यादा से ज़्यादा 10
Webhooks	एक अकाउंट पर ज़्यादा से ज़्यादा 3
Prompt	2,000 अक्षर

जो job फ़ेल या blocked हो रही है, वह आपकी सीमा में गिनी जाना बंद हो जाती है, क्योंकि उसका कोई खर्च नहीं होता। आपका बैलेंस हमेशा आखिरी सीमा है।

Errors

Code	Status	क्या करें
`invalid_request`	400	फ़ील्ड जाँचें। `reason` गलत फ़ील्ड का नाम बता सकता है।
`invalid_json`	400	body सही JSON नहीं है
`idempotency_key_required`	400	`Idempotency-Key` header जोड़ें
`key_missing`	401	`Authorization` header जोड़ें
`key_invalid`	401	key जाँचें
`key_revoked`	401	यह key Revoke हो चुकी है। नई बनाएँ।
`key_expired`	401	यह key की मियाद खत्म हो गई है। नई बनाएँ।
`insufficient_credits`	402	टॉप अप करें। `need` और `have` बताते हैं कि कितना चाहिए और कितना है।
`spend_cap_reached`	402	इस key की सीमा बढ़ाएँ, या इंतज़ार करें
`plan_required`	403	ऐसे प्लान पर जाएँ जिसमें API हो
`api_closed`	403	इस अकाउंट के लिए API खुली नहीं है
`scope_missing`	403	`scope` में जो scope लिखा है, उसे इस key में जोड़ें
`feature_closed`	403	यह टूल इस अकाउंट के लिए खुला नहीं है
`account_blocked`	403	सपोर्ट से बात करें
`email_unverified`	403	वेबसाइट पर अपना ईमेल वेरिफ़ाई करें
`terms_not_accepted`	403	वेबसाइट पर ताज़ा terms मानें
`age_required`	403	वेबसाइट पर अपनी उम्र की पुष्टि करें
`not_found`	404	इस अकाउंट पर ऐसा कोई id नहीं है
`asset_not_found`	404	request में दिया गया कोई asset id इस अकाउंट पर नहीं है
`idempotency_conflict`	409	यह key किसी दूसरी request के साथ इस्तेमाल हो चुकी है। नई key लगाएँ।
`idempotency_in_progress`	409	पहली call अभी चल रही है। रुकें और फिर कोशिश करें।
`content_blocked`	422	content नियमों ने रोक दिया। कुछ भी चार्ज नहीं हुआ।
`prompt_required`, `text_required`	422	शब्द जोड़ें
`text_too_long`	422	उसे `max` तक छोटा करें
`ratio_not_supported`, `count_not_supported`, `seconds_not_supported`, `tier_not_supported`, `mode_not_supported`	422	इस लिस्ट से कोई मान चुनें
`too_many_references`, `reference_required`, `frame_not_supported`, `product_required`	422	request में दी गई तस्वीरें जाँचें
`language_not_supported`, `voice_not_found`	422	`GET /voices` से कोई चुनें
`upload_type`, `upload_size`, `upload_dimensions`, `upload_not_found`, `upload_blocked`	422	फ़ाइल जाँचें
`rights_required`, `consent_required`	422	rights या consent की पुष्टि करें
`influencer_not_ready`, `presenter_not_ready`	422	इसे वेबसाइट पर पूरा करें
`media_not_supported`	422	यह tool इस तरह की फ़ाइल नहीं लेता
`limit_reached`	422	इस अकाउंट की इस tool की सीमा पूरी हो गई
`authorization_pending`, `slow_down`, `access_denied`, `expired_token`	400	ऐप जोड़ें देखें
`rate_limited`	429	`Retry-After` में लिखे सेकंड तक रुकें
`internal_error`	500	हमारी तरफ़ की गलती है। फिर कोशिश करें, और बनी रहे तो `request_id` बताएँ।
`unavailable`	503	थोड़ी देर के लिए रुका है। कुछ देर बाद फिर कोशिश करें।

जो job बुरी तरह खत्म होती है, उसकी अपनी error होती है: generation_failed, जिसमें होल्ड किए गए Credits वापस भेज दिए जाते हैं, या content_blocked।

आम दिक्कतें

धीमी script पर भी rate_limited मिल रहा है

आपकी सीमा हर call गिनती है, job पढ़ने वाली call भी। हर सेकंड पूछने की जगह webhook इस्तेमाल करें।

एक call फ़ेल हुई। क्या मुझसे पैसे कटे?

कोई भी error आपसे पैसे नहीं काटती। पक्का करने के लिए वही call उसी Idempotency-Key के साथ फिर भेजें: अगर job बनी थी तो वही मिलेगी, और नहीं बनी थी तो नई बन जाएगी।

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

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