Freepik का डेवलपर API ज़्यादा समय तक Freepik नहीं रहा। अप्रैल 2026 के अंत से पूरा प्लेटफ़ॉर्म, जिसमें स्टॉक लाइब्रेरी और AI टूल्स दोनों शामिल हैं, Magnific नाम से बिकता है, और पुराना डॉक्यूमेंटेशन पता docs.magnific.com पर रीडायरेक्ट होता है। अगर आप किसी प्रोडक्ट के लिए AI इमेज जनरेशन API का बजट बना रहे हैं, तो नाम बदलने से ज़्यादा मायने उसके नीचे की प्राइस शीट रखती है, क्योंकि आपके बिल के दो बहुत अलग हिस्से होते हैं: एक सस्ता इमेज जनरेटर (Mystic के साथ Flux और Seedream मॉडल की लंबी सूची) और एक अपस्केलर, जिसकी कीमत पिक्सल में आउटपुट साइज़ के साथ बढ़ती है।
यह लेख बताता है कि दस्तावेज़ क्या कहते हैं, थर्ड-पार्टी ट्रैकर क्या रिपोर्ट करते हैं, और दोनों कहाँ अलग हैं, ताकि आप इंटीग्रेशन कोड लिखने से पहले मासिक खर्च का असली अनुमान लगा सकें। जो documented चिह्नित है वह आधिकारिक दस्तावेज़ों से है। जो reported चिह्नित है वह बाहरी स्रोतों से है और उसे अपने डैशबोर्ड से मिलाकर देखना चाहिए।
Freepik अब Magnific है
2026 के कई प्राइसिंग लेखों के अनुसार यह बदलाव 28 अप्रैल 2026 को हुआ, जब Magnific स्टॉक एसेट्स और इमेज, वीडियो, ऑडियो, 3D और डिज़ाइन में फैले AI सूट, दोनों का एकमात्र ब्रांड बन गया। API यूज़र्स के लिए दिखने वाले असर छोटे हैं, पर असली हैं।
नाम बदलने से क्या बदला
- Docs पता:
docs.freepik.com पर जाने पर स्थायी रीडायरेक्ट docs.magnific.com पर मिलता है (documented)।
- Authentication header: मौजूदा दस्तावेज़ header का नाम Freepik की जगह Magnific के नाम पर बताते हैं (documented)।
- पुराने होस्ट: सितंबर 2026 के अंत में अपडेट किया गया एक लेख कहता है कि माइग्रेशन के दौरान
api.freepik.com और api.magnific.com दोनों अब भी स्वीकार किए जा रहे थे (reported)।
💡 टिप: होस्ट और header के नाम एक ही config फ़ाइल में रखें। अगला नाम बदलना एक लाइन का बदलाव बन जाएगा, न कि पूरे codebase में खोज।
वे endpoints जिन्हें आप कॉल करेंगे
तीन endpoints इमेज प्रोजेक्ट्स का लगभग सारा काम करते हैं। इन सभी में प्रक्रिया asynchronous है: आप एक job सबमिट करते हैं, एक task_id और एक status पाते हैं, फिर या तो परिणाम के लिए poll करते हैं या webhook_url को आपको कॉल बैक करने देते हैं। Mystic tasks CREATED से IN_PROGRESS में जाते हैं और या तो पूरे हो जाने की स्थिति पर खत्म होते हैं या FAILED पर (documented)।
| काम | मेथड और पाथ | नोट्स |
|---|
| Generate with Mystic | POST /v1/ai/mystic | टेक्स्ट से इमेज, वैकल्पिक style और structure references |
| Creative upscale | POST /v1/ai/image-upscaler | प्रॉम्प्ट से निर्देशित होकर नई डिटेल जोड़ सकता है |
| Precision upscale | POST /v1/ai/image-upscaler-precision | मूल कंटेंट बनाए रखता है, कोई नई डिटेल नहीं जोड़ता |
एक सामान्य इंटीग्रेशन तीनों के लिए इन्हीं चार चरणों का पालन करता है:
- अपना प्रॉम्प्ट या सोर्स इमेज URL भेजें और आदर्श रूप से एक
webhook_url भी।
- लौटाए गए
task_id को अपने रिकॉर्ड के साथ सेव करें, जैसे किसी ऑर्डर या प्रोडक्ट ID के साथ।
- Webhook का इंतज़ार करें, या task endpoint को उचित अंतराल पर poll करें।
- आउटपुट तुरंत डाउनलोड करें और उसे अपने bucket में सेव करें।

API आपसे बिल कैसे लेता है
सबसे पहले तय करें कि आपकी कॉल्स का भुगतान कौन-सा बैलेंस करता है। इस API के बजट में यहीं सबसे आसान गलती होती है।
क्रेडिट, सब्सक्रिप्शन नहीं
दस्तावेज़ बताते हैं कि हर AI request, चाहे इमेज हो, वीडियो, ऑडियो, upscaling या editing, आपकी organization के बैलेंस से क्रेडिट काटती है (documented)। कंज़्यूमर प्लान एक अलग प्रोडक्ट हैं। ट्रैकर Premium की कीमत वार्षिक बिलिंग पर €12 प्रति माह और 240,000 क्रेडिट सालाना बताते हैं, और Premium+ की €27 प्रति माह और 600,000 क्रेडिट (reported)। कई लेख API को एक अलग, प्री-पेड डेवलपर सेवा बताते हैं, इसलिए शिप करने से पहले पक्का करें कि आपकी requests किस बैलेंस से क्रेडिट लेती हैं। एक आसान तरीका: एक 1K Mystic generation चलाएँ, फिर पहले और बाद का बैलेंस तुलना करें। यही एक टेस्ट आपको आपके अपने अकाउंट पर मापी गई प्रति इमेज कीमत देगा।
ट्रैकर्स से प्रति इमेज कीमतें
आधिकारिक दस्तावेज़ upscaler की प्राइस टेबल प्रकाशित करते हैं, पर हर मॉडल की generation टेबल नहीं। नीचे के आँकड़े थर्ड-पार्टी प्राइस ट्रैकर्स से हैं, इसलिए इन्हें प्रारंभिक अनुमान मानें।
| मॉडल | रिपोर्ट की गई प्रति इमेज कीमत |
|---|
| Classic Fast | $0.005 |
| Flux Dev | $0.012 |
| Flux 2 Pro (1K) | $0.04 |
| Flux Kontext Pro | $0.04 |
| Flux Pro 1.1 | $0.043 |
| HyperFlux | $0.161 |
⚠️ असामान्य आँकड़ों पर ध्यान दें: सितंबर 2026 के अंत में अपडेट किया गया एक लेख अब भी Mystic generation को 100 creations पर 0.40 बताता है, यानी प्रति creation लगभग 0.004। यह ऊपर दिए Flux 2 Pro की कीमत से लगभग दस गुना कम है। इतना बड़ा अंतर इस बात का अच्छा कारण है कि बजट बनाने से पहले लाइव प्राइस लिस्ट पढ़ें।
मुफ़्त क्रेडिट और खर्च सीमा
लेख लगभग 5 मुफ़्त स्टार्टर क्रेडिट बताते हैं (एक में यूरो, दूसरे में डॉलर) और सेल्फ़-सर्विस की प्रति माह 500 की सीमा, जिसके बाद आपको सेल्स टीम से बात करनी होगी (reported)। अगर आपके प्लान को इससे ज़्यादा चाहिए, तो जल्दी custom समझौते के लिए पूछें, क्योंकि वही पेज कहते हैं कि ऊँची सीमाएँ सेल्स टीम के ज़रिए जाती हैं।

Mystic और मॉडल कैटलॉग
Mystic Freepik का इन-हाउस टेक्स्ट-टू-इमेज इंजन है, और इसकी parameter सूची अपनी टेबल की हकदार है।
Mystic के ज़रूरी parameters
| पैरामीटर | मान | डिफ़ॉल्ट |
|---|
resolution | 1k, 2k, 4k | 2k |
aspect_ratio | 13 प्रीसेट जैसे widescreen_16_9, social_story_9_16, classic_4_3 | square_1_1 |
model | zen, flexible, fluid, realism, super_real, editorial_portraits | realism |
engine | automatic, magnific_illusio, magnific_sharpy, magnific_sparkle | automatic |
creative_detailing | 0 से 100 | 33 |
fixed_generation | true या false | false |
structure_reference, style_reference | Base64 इमेज | कोई नहीं |
filter_nsfw | true या false | true |
दो बातें डीबगिंग का समय बचाती हैं। पहली, prompts में character references @character_name या @character_name::strength के रूप में लिखे जा सकते हैं। दूसरी, filter_nsfw स्टैंडर्ड यूज़र्स के लिए बंद नहीं किया जा सकता, इसलिए इस API से वयस्क कंटेंट बिल्कुल पास नहीं होगा। नाम से देखें तो super_real और editorial_portraits फ़ोटोग्राफ़िक काम की ओर इशारा करते हैं, जबकि zen और fluid पेंटरली आउटपुट के ज़्यादा करीब लगते हैं। किसी एक को चुनने से पहले हर एक का छोटा टेस्ट बैच चलाएँ, हर बार एक ही प्रॉम्प्ट के साथ, ताकि केवल मॉडल ही बदलने वाला चर हो।
अन्य टेक्स्ट-टू-इमेज मॉडल
Mystic के अलावा दस्तावेज़ Flux Kontext Pro, Flux 2 Pro, Flux 2 Turbo, Flux 2 Klein, Flux Pro 1.1, Flux Dev, Hyperflux, Seedream 4, Seedream 4.5, Z-Image Turbo और एक Runway टेक्स्ट-टू-इमेज endpoint सूचीबद्ध करते हैं (documented)। यही विस्तार असली आकर्षण है: एक इंटीग्रेशन और एक बैलेंस, कई जनरेटर।
नाम इनके इरादा किए गए कामों का संकेत देते हैं। Kontext Pro Flux Kontext लाइन का है, जो टेक्स्ट निर्देश से मौजूदा तस्वीर को एडिट करने के लिए बनी है। Turbo और Klein वर्ज़न तेज़ी और प्रति इमेज कम लागत का संकेत देते हैं। Seedream 4.5 और Flux 2 Pro पॉलिश्ड मार्केटिंग विज़ुअल्स के लिए आम पसंद हैं। चूँकि कैटलॉग तेज़ी से बदलता है, किसी मॉडल का नाम हार्ड-कोड करने से पहले लाइव मॉडल सूची पढ़ें, और नाम को सोर्स कोड में नहीं, configuration में रखें।

Magnific Upscaler की साइज़ के अनुसार कीमतें
बिल यहीं बढ़ता है। दोनों मोड 2x, 4x, 8x और 16x factors सपोर्ट करते हैं, और दोनों की कीमत कॉल्स की संख्या से नहीं, बल्कि आउटपुट के पिक्सल क्षेत्रफल से तय होती है (documented)।
क्रिएटिव मोड
क्रिएटिव endpoint scale_factor, optimized_for, prompt, creativity, hdr, resemblance, fractality, engine और webhook_url स्वीकार करता है। व्यवहार में यह आपकी फ़ोटो से निर्देशित जनरेटर की तरह काम करता है: यह ऐसी texture और depth जोड़ता है जो सोर्स में थी ही नहीं। यह illustration, concept art और उन नरम फ़ोटो के लिए ठीक है जिन्हें थोड़ी जान चाहिए। जिन चेहरों को हर हाल में वफ़ादार रखना है या जिस इमेज में टेक्स्ट है, उसके लिए यह अच्छा विकल्प नहीं है, क्योंकि जोड़ी गई डिटेल दोनों को बदल सकती है।
दस्तावेज़ सलाह देते हैं कि जब भी संभव हो, मूल इमेज URL से भेजें। Base64 uploads और canvas exports upscaler तक पहुँचने से पहले ही क्वालिटी खो देते हैं।

प्रिसिज़न मोड
प्रिसिज़न मोड, जो समीक्षाओं के अनुसार 2025 के मध्य में आया, नई सामग्री का हैलुसिनेशन किए बिना इमेज को बड़ा करता है। लोगो, इंटरफ़ेस स्क्रीनशॉट, प्रोडक्ट शॉट्स और स्कैन के लिए यह ज़्यादा सुरक्षित विकल्प है। दस्तावेज़ सबसे छोटी किनारी पर कम से कम 256 से 512 पिक्सल का इनपुट, ग्राफ़िक्स के लिए PNG, फ़ोटो के लिए उच्च-क्वालिटी JPEG या PNG, और 2x से 4x के संयमित factors की सलाह देते हैं, क्योंकि इससे आगे जाने पर noise बढ़ता है।
दोनों मोड में से चुनने का एक त्वरित तरीका:
| आपकी सोर्स इमेज | बेहतर मोड | कारण |
|---|
| लोगो, आइकन या इंटरफ़ेस स्क्रीनशॉट | प्रिसिज़न | किनारे और अक्षर नहीं बदलने चाहिए |
| कैटलॉग के लिए प्रोडक्ट फ़ोटो | प्रिसिज़न | ग्राहक असली चीज़ की उम्मीद करता है |
| पुराना स्कैन या भारी कंप्रेस्ड फ़ोटो | क्रिएटिव, कम स्ट्रेंथ | गायब texture कहीं से आना ही होगा |
| Illustration या concept art | क्रिएटिव | अतिरिक्त डिटेल का स्वागत है |
| असली व्यक्ति का पोर्ट्रेट | प्रिसिज़न, या कम स्ट्रेंथ पर क्रिएटिव | गढ़ी गई डिटेल चेहरे से भटक सकती है |

तीन प्राइस पॉइंट्स क्या बताते हैं
दस्तावेज़ तीन worked examples देते हैं, जो दोनों मोड के लिए एक जैसे हैं। मेगापिक्सल वाले कॉलम मेरी ओर से जोड़े गए हैं, ताकि पैटर्न दिखे।
| इनपुट | आउटपुट | Factor | कीमत | आउटपुट साइज़ | प्रति मेगापिक्सल कीमत |
|---|
| 640×480 | 1280×960 | 2x | €0.10 | 1.23 MP | लगभग €0.081 |
| 1920×1080 | 3840×2160 | 2x | €0.20 | 8.29 MP | लगभग €0.024 |
| 640×480 | 5120×3840 | 8x | €0.50 | 19.66 MP | लगभग €0.025 |
इन तीन बिंदुओं से दो बातें संभव लगती हैं (मेरा अनुमान, प्रकाशित फ़ॉर्मूला नहीं)। छोटे आउटपुट लगभग दस सेंट के एक निचले स्तर पर टिकते लगते हैं, और बड़े आउटपुट लगभग ढाई सेंट प्रति मेगापिक्सल के आसपास स्थिर होते हैं। व्यावहारिक सबक: एक छोटी इमेज को 8x तक upscale करना एक फ़ुल HD फ़्रेम को 2x तक upscale करने से ज़्यादा महंगा पड़ता है, इसलिए factor चुनने से पहले अंतिम पिक्सल साइज़ तय करें।

रेट लिमिट और छिपे जाल
Request की सीमाएँ और समाप्त होने वाले लिंक
दस्तावेज़ों में दी गई सीमाएँ ज़्यादातर प्रोजेक्ट्स के लिए उदार हैं (documented):
- प्रति IP पता: 5 सेकंड की विंडो में 50 hits प्रति सेकंड, और 2 मिनट में औसतन 10 hits प्रति सेकंड।
- प्रति credential: 30,000 requests प्रति मिनट।
- दैनिक सीमाएँ: ज़्यादातर endpoints के लिए कोई नहीं। कुछ सहायक सेवाएँ, जैसे इमेज-टू-प्रॉम्प्ट और सर्च, प्रति दिन 100,000 requests तक सीमित हैं।
- Custom सीमाएँ: सेल्स टीम के ज़रिए उपलब्ध।
प्रति-IP संख्याएँ तब मायने रखती हैं जब workers का एक बड़ा समूह एक ही outbound पता साझा करे। दस workers, जिनमें हर एक प्रति सेकंड पाँच requests भेजता है, 2 मिनट के औसत 10 प्रति सेकंड से कहीं ज़्यादा हो जाएँगे। एक छोटी queue जोड़ें, और जब request throttle हो तो exponential backoff लगाएँ, तो यह सीमा आपके यूज़र्स को दिखेगी ही नहीं।
जो सीमा असल में परेशान करती है, वह कोई rate है ही नहीं। आउटपुट लिंक जनरेशन के 30 मिनट बाद समाप्त हो जाते हैं, इसलिए जैसे ही task बताए कि वह पूरा हो गया है, हर परिणाम को तुरंत अपने storage में कॉपी करें। बार-बार चलने वाले polling loops के बजाय webhooks को प्राथमिकता दें, और हर FAILED task लॉग करें, ताकि विंडो बंद होने से पहले उसे दोबारा चला सकें।

असली प्रोजेक्ट्स के लिए बजट गणित
1,000 इमेज का कैटलॉग
मान लीजिए एक ऑनलाइन दुकान को 1,000 प्रोडक्ट विज़ुअल्स चाहिए, जिनमें से हर एक एक बार जनरेट हो और 4K तक upscale किया जाए। रिपोर्ट की गई Flux 2 Pro कीमत और दस्तावेज़ों में दी गई upscaler कीमत का उपयोग करते हुए:
| चरण | यूनिट कीमत | संख्या | कुल |
|---|
| 1K पर Flux 2 Pro से जनरेट | $0.04 | 1,000 | लगभग $40 |
| 1920×1080 को 3840×2160 तक upscale | €0.20 | 1,000 | €200 |
| केवल सबसे अच्छी 200 को अपस्केल | €0.20 | 200 | €40 |
अपस्केलिंग लगभग generate करने से पाँच गुना महंगा पड़ता है, इसलिए सबसे सस्ती बचत क्यूरेशन है: पहले विजेता चुनें और केवल उन्हीं को upscale करें। छोटे thumbnails भी यही व्यवहार करते हैं। 640×480 से 1280×960 तक 5,000 इमेज upscale करना, हर एक €0.10 पर, €500 बनता है, जो पहले बताई गई सेल्फ़-सर्विस मासिक सीमा के बराबर है।
💡 टिप: वह resolution जेनरेट करें जिसकी आपको ज़रूरत है, और जब लेआउट में 2k आउटपुट पहले से फ़िट हो जाए तो upscaler छोड़ दें। हर upscale जो आप टालते हैं, उसकी पूरी यूनिट कीमत बचती है।
पाँच आदतें बिल को स्थिर रखती हैं, जैसे-जैसे वॉल्यूम बढ़ता है:
- केवल स्वीकृत इमेज को upscale करें। ड्राफ़्ट पर कभी upscaler न चलाएँ।
- 2x से शुरू करें। 4x या 8x पर तभी जाएँ जब असली लेआउट को पिक्सल की ज़रूरत हो।
- हर task लॉग करें। Task ID, मॉडल, आउटपुट साइज़ और प्रति प्रोजेक्ट लागत सेव करें, ताकि इनवॉइस पर आया कोई झटका मिनटों में ट्रेस हो सके।
- दोबारा चलाने के लिए 10 से 15 प्रतिशत का buffer जोड़ें, जब कोई परिणाम ब्रीफ़ से चूक जाए।
- आते ही आउटपुट सेव करें। 30 मिनट में समाप्त होने वाला लिंक एक ऐसी दोबारा-रन है जिसके लिए आप दो बार पैसे देते हैं।

फिट बैठने वाले Picasso IA मॉडल
अगर किसी API के लिए प्रतिबद्ध होने से पहले गुणवत्ता की तुलना करना चाहते हैं, तो Picasso IA वर्कफ़्लो के दोनों हिस्सों के करीबी विकल्प होस्ट करता है, और आप उन्हें पहले ब्राउज़र में आज़मा सकते हैं।
टेक्स्ट-टू-इमेज के समकक्ष
Upscaler के समकक्ष
यह जोड़ी भावना की है, पहचान की नहीं। हर मॉडल का अपना रूप होता है, इसलिए फ़ैसला करने से पहले वही टेस्ट फ़ोटो दो-तीन में चलाएँ।
Clarity Pro Upscaler कैसे इस्तेमाल करें
Clarity Pro Upscaler Magnific के क्रिएटिव मोड का सबसे करीबी मेल है, क्योंकि इसमें एक ही creativity control है। बड़ा करते समय यह चेहरे की संरचना, त्वचा के रोम-छिद्र और बालों की लटें बरकरार रखता है।
- मॉडल पेज खोलें और इमेज अपलोड करें। इमेज ही एकमात्र ज़रूरी इनपुट है।
scale_factor सेट करें। डिफ़ॉल्ट 2 है। अपने लक्ष्य साइज़ के अनुसार 2, 4, 8 या 16 चुनें।
creativity ट्यून करें। डिफ़ॉल्ट 0 है। नकारात्मक मान मूल के करीब रहते हैं, सकारात्मक मान texture और depth जोड़ते हैं।
output_format चुनें। PNG lossless है और डिफ़ॉल्ट है। JPG 95% क्वालिटी पर चलता है और छोटी फ़ाइलें देता है।
- मॉडल चलाएँ और परिणाम डाउनलोड करें। उसे तुरंत सेव करें।
💡 टिप: creativity 0 पर रखकर 2x से शुरू करें, फिर एक बार में एक सेटिंग बदलें। scale और creativity एक साथ बदलने से यह पहचानना मुश्किल होता है कि बदलाव किससे हुआ।
Picasso IA पर आज़माएँ
डेवलपर Picasso IA को प्रोग्रामैटिक रूप से भी कॉल कर सकते हैं। इसका API https://api.picassoia.com/v1 पर है और ऊपर के Freepik फ़्लो जैसा ही पैटर्न अपनाता है: prediction बनाएँ, उसे poll करें, परिणाम लाएँ। इस लेख के लिखे जाने के समय यह चार मॉडल (इमेज, इमेज एडिटिंग, वीडियो और ऑडियो वाला वीडियो) देता था, प्रति अकाउंट 5 एक साथ predictions के साथ। उस समय साइट पर कॉस्ट और प्लान की आवश्यकताओं का विवरण एक जैसा नहीं था, इसलिए इस पर निर्माण करने से पहले प्राइसिंग पेज पर पक्का करें।
बिना किसी इंटीग्रेशन के त्वरित टेस्ट के लिए, एक नरम, कम रिज़ॉल्यूशन वाली फ़ोटो लें, उसे 2x पर Clarity Pro Upscaler से चलाएँ, फिर उसी फ़ाइल पर Topaz Image Upscale आज़माएँ। Flux 2 Pro से एक नई इमेज जनरेट करें और उसे भी उन्हीं चरणों से गुज़ारें। एक दोपहर के भीतर आपको पता चल जाएगा कि कौन-सा रूप आपके प्रोजेक्ट में फ़िट बैठता है, और Magnific की प्राइस लिस्ट से तुलना के लिए आपके पास असली आँकड़े होंगे। आज ही एक फ़ोटो चुनें, एक मॉडल खोलें और अपना पहला टेस्ट चलाएँ।
