Skip to main content
एक ही Gemini native endpoint से टेक्स्ट चित्र, संदर्भ संपादन और आगे के संपादन करें। उदाहरण nano-banana-2.1 उपयोग करते हैं; अन्य दोनों के लिए URL या SDK का मॉडल ID बदलें।
BetterToken API खोज की मदद से चित्र बनाना समर्थित नहीं करता, जिसमें Google वेब खोज और चित्र खोज grounding शामिल हैं। खोज टूल न जोड़ें।

कनेक्शन जानकारी

BetterToken API Key बनाएं · मॉडल कैटलॉग · Nano Banana मॉडल परिचय
ये तीनों मॉडल POST /v1/images/generations और POST /v1/images/edits स्वीकार नहीं करते; 400 unsupported_endpoint लौटता है। GPT Image के multipart, image[] या data[].b64_json उदाहरण न अपनाएं।

पहला चित्र बनाएं

टर्मिनल में BETTERTOKEN_API_KEY सेट करके अनुरोध चलाएं। यह निर्माण पूरा होने तक इंतज़ार करता है और पूरा JSON response.json में सहेजता है।
बड़े रिज़ॉल्यूशन के लिए imageSize को 2K या 4K करें। पहले 1K, 1:1 और एक चित्र से शुरू करें। --retry से स्वचालित दोबारा अनुरोध न जोड़ें।

सामान्य पैरामीटर

उत्पाद फ़ोटो के लिए विषय, सामग्री, रोशनी और पृष्ठभूमि बताएं। पोस्टर के लिए सटीक टेक्स्ट और लेआउट दें। संपादन में क्या बदलना और क्या रखना है बताएं। Native HTTP में नीचे के फ़ील्ड और Python SDK में snake_case उपयोग होता है। चित्र सेटिंग generationConfig.imageConfig के अंदर रखें।

Google के समर्थित अनुपात

Nano Banana 2 और 2.1 में 14 अनुपात और Pro में 10 समर्थित हैं। पहले अनुरोध में 1:1 से शुरू करें। Google अनुपात और चित्र आकार संदर्भ यह अधिकतम संख्या की गारंटी नहीं है। कई चित्र मांगने पर भी एक मिल सकता है। निश्चित संख्या के लिए अलग-अलग अनुरोध भेजें।

प्रतिक्रिया पढ़ें और चित्र सहेजें

चित्र candidates[].content.parts[].inlineData में होते हैं। नीचे की संरचना में BASE64_IMAGE_DATA केवल placeholder है। सभी अंतिम चित्र parts पढ़ें और thought: true वाले भाग छोड़ें।
यह Python, curl का परिणाम सहेजता है। mimeType से extension चुनें; चित्र JPEG हो सकता है, हमेशा .png नहीं।

पूरा Python SDK उदाहरण

Python 3.10 या नया और google-genai==2.30.1 उपयोग करें। प्रोजेक्ट virtual environment में इंस्टॉल करें; पुराने SDK image_size भेजना छोड़ सकते हैं।
SDK Base URL डोमेन root है, /v1 या /v1beta नहीं जोड़ें। timeout मिलीसेकंड में है और attempts=1 स्वचालित retry बंद करता है। save_images सभी अंतिम चित्र सहेजता है।

संदर्भ चित्र भेजें

Python उदाहरण के बाद चलाने पर नया संपादन अनुरोध भेजता है। reference.jpg को अपनी फ़ाइल से बदलें। PNG के लिए mime_type="image/png" दें। अधिक संदर्भ उसी user संदेश के parts में जोड़ें।
Native JSON में inlineData: {"mimeType": "image/jpeg", "data": "BASE64_IMAGE_DATA"} दें। मूल bytes का base64 बनाएं; data:image/...;base64, prefix न दें। multipart, Files या fileData उपयोग नहीं होता।

आगे संपादन करें

सफल निर्माण या संदर्भ संपादन के बाद चलाएं। मॉडल का पूरा content, parts का क्रम और thoughtSignature रखें। केवल चित्र से इतिहास न बनाएं और हस्ताक्षर न गढ़ें या बदलें।
हर चरण नया निर्माण अनुरोध है। पूरा history रखें, नया user निर्देश और फिर मॉडल का content जोड़ें। यहां Interactions का previous_interaction_id न दें।

API का समर्थन

  • बिना streaming वाला generateContent उपयोग करें। इस कनेक्शन में Files / fileData, Batch, Interactions और streaming समर्थित नहीं हैं।
  • responseMimeType, responseSchema और कस्टम चित्र compression format समर्थित नहीं हैं। imageConfig में केवल ऊपर दिए दो फ़ील्ड उपयोग करें।
  • cachedContent, function calling, code execution, फ़ाइल खोज, Maps, URL context और ऑडियो इनपुट या निर्माण की सेटिंग न जोड़ें।

मौजूदा OpenAI Chat क्लाइंट

POST /v1/chat/completions और Base URL https://bettertoken.ai/v1 उपयोग कर सकते हैं। नए कनेक्शन, संदर्भ और लगातार संपादन के लिए ऊपर दिया Gemini native API उपयोग करें। Chat में n छोड़ें या पूर्णांक 1 दें। HTTP में google.image_config JSON root पर रखें। Python OpenAI SDK में extra_body दें, जिसे SDK root में जोड़ता है। यहां generationConfig न दें।
Python OpenAI SDK उदाहरण के लिए उसी virtual environment में openai==1.66.2 इंस्टॉल करें:
Chat चित्र choices[0].message.content में Markdown Data URL होते हैं, Images API के data[] में नहीं। इस टेक्स्ट से हस्ताक्षर इतिहास न बनाएं; native संपादन उपयोग करें।

सामान्य त्रुटियां

चित्र वर्तमान प्रतिक्रिया में मिलता है। इस कार्यप्रवाह में बाद में चित्र प्राप्त करने या task polling का endpoint नहीं है। परिणाम तुरंत सहेजें, SDK और proxy में पर्याप्त समय रखें और स्वचालित retry बंद करें।

आधिकारिक स्रोत