Gemini Nano Banana 2.1 je model Googlu pro generování obrázků a konverzační úpravy. Jde o aktualizaci Nano Banana 2 s vylepšením vizuálního realismu, dodržování instrukcí, vykreslování textu a konzistence postav napříč navazujícími úpravami. Tabulka vstupů zahrnuje text, obrázky, video a PDF, zatímco výstupem jsou obrázky a text. Díky tomu se hodí pro produktovou scénu, infografiku nebo vizuální sérii, která se rozvíjí prostřednictvím několika konkrétních revizí.
Model nabízí výstup 1K, 2K a 4K, přičemž výchozí je 1K. Nepřebírá možnost 0.5K z Nano Banana 2. Dokumentované poměry stran zahrnují 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 a také vysoké či panoramatické formáty 1:4, 4:1, 1:8 a 8:1. Google uvádí opravy artefaktů dlaždicování v těchto posledně uvedených širokých a vysokých formátech při 2K a 4K. Označení rozlišení představují velikostní úrovně, nikoli jeden pevný obdélník: čtvercový obrázek 4K má 4096 × 4096, zatímco dokumentovaný výstup 16:9 ve 4K má 5504 × 3072.
Text je významnou součástí vizuálního pracovního postupu. Model je navržen k vykreslování čitelného stylizovaného znění a přesnějšímu uspořádání prvků infografik. Připravte přesný nadpis, popisky a pořadí čtení a poté požadujte obrázek s tímto schváleným textem. U nabídky, diagramu nebo instruktážní grafiky pojmenujte vztah mezi popiskem a jeho vizuálním prvkem. Google doporučuje nejprve vytvořit znění a následně požádat o obrázek, aby vizuální kompozice vycházela z uzavřeného textového zadání.
Propojování referenčních obrázků podporuje až 14 obrázků. Dokumentovaný profil zahrnuje konzistenci až čtyř postav a věrnost až deseti objektů. Každé referenci přiřaďte roli: produkt, který musí zůstat rozpoznatelný, vzhled postavy, zamýšlené pozadí nebo vizuální styl. Příkladem produktového zadání je: „Obrázek A použij pro tvar lahve a etiketu. Obrázek B použij pro povrch a osvětlení. Produkt zachovej beze změny, umísti jej vedle složeného ručníku a nad ním nech volné místo pro dodaný nadpis.“
Ukotvení pomocí Google Web Search a Image Search může pro generování dodat aktuální informace a vizuální kontext. Image Search poskytuje nalezené webové obrázky jako reference; standardní webové ukotvení dodává informace o tématu. To je užitečné pro faktografickou grafiku nebo scénu, jejíž vzhled závisí na skutečném objektu. Pracovní postup vyhledávání obrázků nepodporuje získávání skutečných fotografií lidí pro tento účel. Ukotvené odpovědi v dokumentovaném postupu Googlu nesou metadata zdrojů a atribuce, proto by je aplikace měla uchovat spolu s vygenerovaným výsledkem.
Přemýšlení lze nastavit na úrovně minimal, medium a high, přičemž pro tento přesný model je výchozí medium. Pomáhá modelu před závěrečným výstupem promyslet kompozici a složitější pokyny. Průvodce obrázky popisuje průběžné kompoziční obrázky v rámci tohoto procesu; ty se liší od zamýšleného konečného výstupu. Požadované závěrečné rozvržení, poměr stran a rozlišení zvolte výslovně, místo abyste očekávali, že samotný popis v promptu určí veškerá nastavení výstupu.
Konverzační úpravy umožňují navazujícím požadavkem změnit jednu část existujícího výsledku: upravit světlo, přesunout objekt nebo přeložit popisky při zachování zbytku kompozice. Přeneste předchozí obrázek nebo interakci do dalšího kroku konverzace a uveďte požadovanou změnu i prvky, které mají zůstat zachovány. U série postav udržujte konzistentní reference vzhledu a použijte referenci pózy, pokud záleží na novém úhlu nebo složité póze. Praktické zadání revize může znít: „Zachovej produkt, popisky a rozvržení; pouze pozadí změň na teplejší šedou.“
Tabulka modelu uvádí vstupní limit 131,072 tokenů a výstupní limit 32,768 tokenů. Generování obrázků a ukotvení ve vyhledávání jsou podporovány, zatímco generování zvuku, spouštění kódu, volání funkcí, strukturované výstupy, ukládání do mezipaměti, vyhledávání v souborech, URL context a Live API nejsou pro tuto edici uvedeny jako podporované. Video může poskytnout podklady pro vygenerovaný statický obrázek; nedělá z tohoto modelu generátor videa. Google také upozorňuje, že požadavek na přesný počet obrázků nemusí vést k vytvoření právě tohoto počtu. Všechny generované obrázky obsahují vodoznak SynthID.
Pro užitečné úvodní zadání uveďte účel obrázku, námět, kompozici, osvětlení, pohled kamery, požadovaný text a tvar výstupu. Například požadujte infografiku na výšku se třemi popsanými kroky, čitelným nadpisem a určenou barevnou hierarchií a před další úpravou zkontrolujte znění a vzájemné umístění. Výsledek se může stát produktovou ilustrací, redakční grafikou nebo designovou předlohou, přičemž zvolený obrázek a jeho vysvětlující text zůstanou uchovány společně.
", "aboutText": "Gemini Nano Banana 2.1 je model Googlu pro generování obrázků a konverzační úpravy. Jde o aktualizaci Nano Banana 2 s vylepšením vizuálního realismu, dodržování instrukcí, vykreslování textu a konzistence postav napříč navazujícími úpravami. Tabulka vstupů zahrnuje text, obrázky, video a PDF, zatímco výstupem jsou obrázky a text. Díky tomu se hodí pro produktovou scénu, infografiku nebo vizuální sérii, která se rozvíjí prostřednictvím několika konkrétních revizí.\n\nModel nabízí výstup 1K, 2K a 4K, přičemž výchozí je 1K. Nepřebírá možnost 0.5K z Nano Banana 2. Dokumentované poměry stran zahrnují 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 a také vysoké či panoramatické formáty 1:4, 4:1, 1:8 a 8:1. Google uvádí opravy artefaktů dlaždicování v těchto posledně uvedených širokých a vysokých formátech při 2K a 4K. Označení rozlišení představují velikostní úrovně, nikoli jeden pevný obdélník: čtvercový obrázek 4K má 4096 × 4096, zatímco dokumentovaný výstup 16:9 ve 4K má 5504 × 3072.\n\nText je významnou součástí vizuálního pracovního postupu. Model je navržen k vykreslování čitelného stylizovaného znění a přesnějšímu uspořádání prvků infografik. Připravte přesný nadpis, popisky a pořadí čtení a poté požadujte obrázek s tímto schváleným textem. U nabídky, diagramu nebo instruktážní grafiky pojmenujte vztah mezi popiskem a jeho vizuálním prvkem. Google doporučuje nejprve vytvořit znění a následně požádat o obrázek, aby vizuální kompozice vycházela z uzavřeného textového zadání.\n\nPropojování referenčních obrázků podporuje až 14 obrázků. Dokumentovaný profil zahrnuje konzistenci až čtyř postav a věrnost až deseti objektů. Každé referenci přiřaďte roli: produkt, který musí zůstat rozpoznatelný, vzhled postavy, zamýšlené pozadí nebo vizuální styl. Příkladem produktového zadání je: „Obrázek A použij pro tvar lahve a etiketu. Obrázek B použij pro povrch a osvětlení. Produkt zachovej beze změny, umísti jej vedle složeného ručníku a nad ním nech volné místo pro dodaný nadpis.“\n\nUkotvení pomocí Google Web Search a Image Search může pro generování dodat aktuální informace a vizuální kontext. Image Search poskytuje nalezené webové obrázky jako reference; standardní webové ukotvení dodává informace o tématu. To je užitečné pro faktografickou grafiku nebo scénu, jejíž vzhled závisí na skutečném objektu. Pracovní postup vyhledávání obrázků nepodporuje získávání skutečných fotografií lidí pro tento účel. Ukotvené odpovědi v dokumentovaném postupu Googlu nesou metadata zdrojů a atribuce, proto by je aplikace měla uchovat spolu s vygenerovaným výsledkem.\n\nPřemýšlení lze nastavit na úrovně minimal, medium a high, přičemž pro tento přesný model je výchozí medium. Pomáhá modelu před závěrečným výstupem promyslet kompozici a složitější pokyny. Průvodce obrázky popisuje průběžné kompoziční obrázky v rámci tohoto procesu; ty se liší od zamýšleného konečného výstupu. Požadované závěrečné rozvržení, poměr stran a rozlišení zvolte výslovně, místo abyste očekávali, že samotný popis v promptu určí veškerá nastavení výstupu.\n\nKonverzační úpravy umožňují navazujícím požadavkem změnit jednu část existujícího výsledku: upravit světlo, přesunout objekt nebo přeložit popisky při zachování zbytku kompozice. Přeneste předchozí obrázek nebo interakci do dalšího kroku konverzace a uveďte požadovanou změnu i prvky, které mají zůstat zachovány. U série postav udržujte konzistentní reference vzhledu a použijte referenci pózy, pokud záleží na novém úhlu nebo složité póze. Praktické zadání revize může znít: „Zachovej produkt, popisky a rozvržení; pouze pozadí změň na teplejší šedou.“\n\nTabulka modelu uvádí vstupní limit 131,072 tokenů a výstupní limit 32,768 tokenů. Generování obrázků a ukotvení ve vyhledávání jsou podporovány, zatímco generování zvuku, spouštění kódu, volání funkcí, strukturované výstupy, ukládání do mezipaměti, vyhledávání v souborech, URL context a Live API nejsou pro tuto edici uvedeny jako podporované. Video může poskytnout podklady pro vygenerovaný statický obrázek; nedělá z tohoto modelu generátor videa. Google také upozorňuje, že požadavek na přesný počet obrázků nemusí vést k vytvoření právě tohoto počtu. Všechny generované obrázky obsahují vodoznak SynthID.\n\nPro užitečné úvodní zadání uveďte účel obrázku, námět, kompozici, osvětlení, pohled kamery, požadovaný text a tvar výstupu. Například požadujte infografiku na výšku se třemi popsanými kroky, čitelným nadpisem a určenou barevnou hierarchií a před další úpravou zkontrolujte znění a vzájemné umístění. Výsledek se může stát produktovou ilustrací, redakční grafikou nebo designovou předlohou, přičemž zvolený obrázek a jeho vysvětlující text zůstanou uchovány společně.", "editorialOverlay": { "copy_fields": { "practical_html": "Technický příklad v angličtině
Refine an approved poster background\n\nEdit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image.One edited poster with the original wording and layout preserved over a warm ivory background.Compare every word and element position against the supplied poster, then inspect text contrast.google/gemini-nano-banana-2.1Gemini Nano Banana 2.1 konverzačně generuje a upravuje obrázky z textu a vizuálních materiálů. Vylepšuje vykreslování textu, rozvržení infografik a konzistenci mezi jednotlivými kroky konverzace; pro vymezené vizuální zadání nabízí výstup 1K–4K a až 14 referenčních obrázků.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Gemini Nano Banana 2.1 je model Googlu pro generování obrázků a konverzační úpravy. Jde o aktualizaci Nano Banana 2 s vylepšením vizuálního realismu, dodržování instrukcí, vykreslování textu a konzistence postav napříč navazujícími úpravami. Tabulka vstupů zahrnuje text, obrázky, video a PDF, zatímco výstupem jsou obrázky a text. Díky tomu se hodí pro produktovou scénu, infografiku nebo vizuální sérii, která se rozvíjí prostřednictvím několika konkrétních revizí.
Model nabízí výstup 1K, 2K a 4K, přičemž výchozí je 1K. Nepřebírá možnost 0.5K z Nano Banana 2. Dokumentované poměry stran zahrnují 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 a také vysoké či panoramatické formáty 1:4, 4:1, 1:8 a 8:1. Google uvádí opravy artefaktů dlaždicování v těchto posledně uvedených širokých a vysokých formátech při 2K a 4K. Označení rozlišení představují velikostní úrovně, nikoli jeden pevný obdélník: čtvercový obrázek 4K má 4096 × 4096, zatímco dokumentovaný výstup 16:9 ve 4K má 5504 × 3072.
Text je významnou součástí vizuálního pracovního postupu. Model je navržen k vykreslování čitelného stylizovaného znění a přesnějšímu uspořádání prvků infografik. Připravte přesný nadpis, popisky a pořadí čtení a poté požadujte obrázek s tímto schváleným textem. U nabídky, diagramu nebo instruktážní grafiky pojmenujte vztah mezi popiskem a jeho vizuálním prvkem. Google doporučuje nejprve vytvořit znění a následně požádat o obrázek, aby vizuální kompozice vycházela z uzavřeného textového zadání.
Propojování referenčních obrázků podporuje až 14 obrázků. Dokumentovaný profil zahrnuje konzistenci až čtyř postav a věrnost až deseti objektů. Každé referenci přiřaďte roli: produkt, který musí zůstat rozpoznatelný, vzhled postavy, zamýšlené pozadí nebo vizuální styl. Příkladem produktového zadání je: „Obrázek A použij pro tvar lahve a etiketu. Obrázek B použij pro povrch a osvětlení. Produkt zachovej beze změny, umísti jej vedle složeného ručníku a nad ním nech volné místo pro dodaný nadpis.“
Ukotvení pomocí Google Web Search a Image Search může pro generování dodat aktuální informace a vizuální kontext. Image Search poskytuje nalezené webové obrázky jako reference; standardní webové ukotvení dodává informace o tématu. To je užitečné pro faktografickou grafiku nebo scénu, jejíž vzhled závisí na skutečném objektu. Pracovní postup vyhledávání obrázků nepodporuje získávání skutečných fotografií lidí pro tento účel. Ukotvené odpovědi v dokumentovaném postupu Googlu nesou metadata zdrojů a atribuce, proto by je aplikace měla uchovat spolu s vygenerovaným výsledkem.
Přemýšlení lze nastavit na úrovně minimal, medium a high, přičemž pro tento přesný model je výchozí medium. Pomáhá modelu před závěrečným výstupem promyslet kompozici a složitější pokyny. Průvodce obrázky popisuje průběžné kompoziční obrázky v rámci tohoto procesu; ty se liší od zamýšleného konečného výstupu. Požadované závěrečné rozvržení, poměr stran a rozlišení zvolte výslovně, místo abyste očekávali, že samotný popis v promptu určí veškerá nastavení výstupu.
Konverzační úpravy umožňují navazujícím požadavkem změnit jednu část existujícího výsledku: upravit světlo, přesunout objekt nebo přeložit popisky při zachování zbytku kompozice. Přeneste předchozí obrázek nebo interakci do dalšího kroku konverzace a uveďte požadovanou změnu i prvky, které mají zůstat zachovány. U série postav udržujte konzistentní reference vzhledu a použijte referenci pózy, pokud záleží na novém úhlu nebo složité póze. Praktické zadání revize může znít: „Zachovej produkt, popisky a rozvržení; pouze pozadí změň na teplejší šedou.“
Tabulka modelu uvádí vstupní limit 131,072 tokenů a výstupní limit 32,768 tokenů. Generování obrázků a ukotvení ve vyhledávání jsou podporovány, zatímco generování zvuku, spouštění kódu, volání funkcí, strukturované výstupy, ukládání do mezipaměti, vyhledávání v souborech, URL context a Live API nejsou pro tuto edici uvedeny jako podporované. Video může poskytnout podklady pro vygenerovaný statický obrázek; nedělá z tohoto modelu generátor videa. Google také upozorňuje, že požadavek na přesný počet obrázků nemusí vést k vytvoření právě tohoto počtu. Všechny generované obrázky obsahují vodoznak SynthID.
Pro užitečné úvodní zadání uveďte účel obrázku, námět, kompozici, osvětlení, pohled kamery, požadovaný text a tvar výstupu. Například požadujte infografiku na výšku se třemi popsanými kroky, čitelným nadpisem a určenou barevnou hierarchií a před další úpravou zkontrolujte znění a vzájemné umístění. Výsledek se může stát produktovou ilustrací, redakční grafikou nebo designovou předlohou, přičemž zvolený obrázek a jeho vysvětlující text zůstanou uchovány společně.
POST /v1/chat/completionstexttext| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity google/gemini-nano-banana-2.1 | Výchozí— |
Polemessages | Typmessage[] | PožadavekPovinné | Hodnoty a limity Minimální počet položek: 1 | Výchozí— |
Polemessages[].role | Typstring | PožadavekPovinné | Hodnoty a limity Příklady: system, user, assistant, tool, function Podmínky: Tyto role jsou výslovně zastoupeny typy kompatibility zdrojového kódu; přesná sada rolí zůstává specifická pro daný model. Závisí na modelu | Výchozí— |
Polemessages[].content | Typstring|content_part[]|null | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polemessages[].tool_calls | Typtool_call[] | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polemessages[].tool_call_id | Typstring | PožadavekVolitelné | Hodnoty a limity Platí, když: role=tool; použijte skutečně vrácené ID | Výchozí— |
Polemessages[].name | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polemessages[].reasoning_content | Typstring | PožadavekVolitelné | Hodnoty a limity Platí, když: Předávejte zpět skutečně vrácené uvažování tam, kde je tento model používá | Výchozí— |
Polemessages[].reasoning_details | Typobject|array | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Polemax_tokens | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Závisí na modelu | Výchozí— |
Polemax_completion_tokens | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Závisí na modelu | Výchozí— |
Polestream | Typboolean | PožadavekVolitelné | Hodnoty a limity | Výchozífalse |
Polestream_options.include_usage | Typboolean | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poletemperature | Typnumber | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poletop_p | Typnumber | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Polestop | Typstring|string[] | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poletools | Typfunction_tool[] | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poletools[].type | Typstring | PožadavekVolitelné | Hodnoty a limity function Závisí na modelu | Výchozí— |
Poletools[].function.name | Typstring | PožadavekPovinné | Hodnoty a limity Platí, když: nástroj typu funkce je dodán | Výchozí— |
Poletools[].function.description | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletools[].function.parameters | TypJSON_schema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletool_choice | Typstring|object | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poleparallel_tool_calls | Typboolean | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poleresponse_format | Typobject | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Polereasoning_effort | Typstring | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Polereasoning | Typobject | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poleservice_tier | Typstring | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poleinstructions | Typstring | PožadavekVolitelné | Hodnoty a limity Pole kompatibility | Výchozí— |
Polefunctions | Typfunction[] | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Polefunction_call | Typstring|object | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Poleprompt_cache_options | Typobject | PožadavekVolitelné | Hodnoty a limity Závisí na modelu | Výchozí— |
Polemodalities | Typstring[] | PožadavekVolitelné | Hodnoty a limity text | Výchozí— |
Poleprovider | Typobject | PožadavekVolitelné | Hodnoty a limity Podmínky: provider.options je na této textové trase Ultra odmítáno | Výchozí— |
Polecache_control.ttl | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: Hodnota 1h je ve skutečných umístěních mezipaměti promptů odmítána | Výchozí— |
Text · text UTF8
messages[].content
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, messages |
Parametrmaterial_types | Kontrakttext |
Parametrmessages | Kontraktpole zpráv se strukturou role/content |
Parametrfile_material | Kontraktskutečný dokument UTF-8 vložený jako doslovný text; ID souboru se neodvozuje |
Parametroptional_controls | Kontraktstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametrcontrol_scope | Kontraktspecifické pro model; nástroje uživatelských funkcí se liší od hostovaných nástrojů |
Parametroutput_modalities | Kontrakttext |
Parametrhosted_operations | Kontraktfalse |
Parametrmultimodal_input_binding | Kontraktnull |
Životní cyklus: synchronous_or_streamed
Odešlete přesné ID modelu spolu s messages.
Délka kontextu není limitem výstupu.
Textový soubor může dodat doslovný text; obrazové/zvukové vstupy a vstupy v podobě souborových objektů vyžadují přesnou vazbu.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Tokeny kontextu, více než | Tokeny kontextu, do uvedené hodnoty včetně | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Tokeny kontextu, více než— | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.003 / 1K tokenů Výstup · Výstupní tokeny $0.015 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů Výstup · Tokeny výstupního obrázku $0.06 / 1K obrazových tokenů |
| KonfiguracePásmo délky požadavku 1 | Tabulka sazeb— | Tokeny kontextu, více než0 | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.003 / 1K tokenů Výstup · Výstupní tokeny $0.015 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceGoogle: Nano Banana 2.1 · Výchozí konfigurace | Podmínky účtováníVýchozí konfigurace | Poplatek Vstup · Vstupní tokeny 0,003 US$ / 1K tokenů Výstup · Výstupní tokeny 0,015 US$ / 1K tokenů Výstup · Výstupní obrázek 0,06 US$ / 1K tokenů Výstup · Vyhledávání na webu 0,028 US$ za vyhledání |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/gemini-nano-banana-2.1", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nfor x in r.get("choices",[]):\n if x.get("message",{}).get("content"): print(x["message"]["content"])\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model='google/gemini-nano-banana-2.1',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nsave_result(result.to_dict(mode="json"))\nfrom openai import OpenAI\nimport os\nfrom pathlib import Path\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nimport base64, json\nfrom pathlib import Path\n\ndef save_result(data, stem="result"):\n # Keep every field, including usage, IDs, reasoning and tool requests.\n Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\n print(json.dumps(data, ensure_ascii=False, indent=2))\n def save_blob(encoded, suffix, label):\n raw = base64.b64decode(encoded, altchars=b"-_", validate=True)\n ext = "png" if raw.startswith(b"\\x89PNG\\r\\n\\x1a\\n") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix\n file = Path(stem + "-" + label + "." + ext)\n file.write_bytes(raw)\n print("Saved", file)\n for index, block in enumerate(data.get("content") or []):\n print("Content", index, json.dumps(block, ensure_ascii=False))\n for choice in data.get("choices") or []:\n print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))\n for index, item in enumerate(data.get("output") or []):\n print("Output", index, json.dumps(item, ensure_ascii=False))\n if item.get("type") == "image_generation_call" and item.get("result"):\n save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))\n for ci, candidate in enumerate(data.get("candidates") or []):\n for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):\n print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))\n blob = part.get("inlineData") or part.get("inline_data")\n if blob and blob.get("data"):\n mime = blob.get("mimeType") or blob.get("mime_type")\n suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")\n save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))\n\nwith client.chat.completions.stream(model='google/gemini-nano-banana-2.1',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:\n with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:\n for event in stream:\n payload=event.to_dict(mode="json")\n log.write(json.dumps(payload,ensure_ascii=False)+"\\n"); log.flush()\n print(json.dumps(payload,ensure_ascii=False))\n final=stream.get_final_completion()\n save_result(final.to_dict(mode="json"),"stream-result")\njson nebo SSE
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Zachovejte každou volbu a její obsah/volání nástrojů/uvažování. V SSE sestavujte přírůstky podle indexu volby/nástroje a zachovejte konečný důvod ukončení i údaje o využití.
Zachovejte ID požadavků/odpovědí a hlavičky. Není dodána obecná URL pro načtení textové úlohy.
| Pole | Typ |
|---|---|
Polechoices[].index | Typinteger |
Polechoices[].message.content | Typstring|null |
Polechoices[].message.tool_calls | Typtool_call[] |
Polechoices[].message.reasoning_content | Typstring |
Polechoices[].message.reasoning_details | Typobject|array |
Polechoices[].finish_reason | Typstring|null |
Poleusage | Typobject |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Ailoot Ultra google/gemini-nano-banana-2.1
/v1/images
google/gemini-nano-banana-2.1Gemini Nano Banana 2.1 konverzačně generuje a upravuje obrázky z textu a vizuálních materiálů. Vylepšuje vykreslování textu, rozvržení infografik a konzistenci mezi jednotlivými kroky konverzace; pro vymezené vizuální zadání nabízí výstup 1K–4K a až 14 referenčních obrázků.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Gemini Nano Banana 2.1 je model Googlu pro generování obrázků a konverzační úpravy. Jde o aktualizaci Nano Banana 2 s vylepšením vizuálního realismu, dodržování instrukcí, vykreslování textu a konzistence postav napříč navazujícími úpravami. Tabulka vstupů zahrnuje text, obrázky, video a PDF, zatímco výstupem jsou obrázky a text. Díky tomu se hodí pro produktovou scénu, infografiku nebo vizuální sérii, která se rozvíjí prostřednictvím několika konkrétních revizí.
Model nabízí výstup 1K, 2K a 4K, přičemž výchozí je 1K. Nepřebírá možnost 0.5K z Nano Banana 2. Dokumentované poměry stran zahrnují 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 a také vysoké či panoramatické formáty 1:4, 4:1, 1:8 a 8:1. Google uvádí opravy artefaktů dlaždicování v těchto posledně uvedených širokých a vysokých formátech při 2K a 4K. Označení rozlišení představují velikostní úrovně, nikoli jeden pevný obdélník: čtvercový obrázek 4K má 4096 × 4096, zatímco dokumentovaný výstup 16:9 ve 4K má 5504 × 3072.
Text je významnou součástí vizuálního pracovního postupu. Model je navržen k vykreslování čitelného stylizovaného znění a přesnějšímu uspořádání prvků infografik. Připravte přesný nadpis, popisky a pořadí čtení a poté požadujte obrázek s tímto schváleným textem. U nabídky, diagramu nebo instruktážní grafiky pojmenujte vztah mezi popiskem a jeho vizuálním prvkem. Google doporučuje nejprve vytvořit znění a následně požádat o obrázek, aby vizuální kompozice vycházela z uzavřeného textového zadání.
Propojování referenčních obrázků podporuje až 14 obrázků. Dokumentovaný profil zahrnuje konzistenci až čtyř postav a věrnost až deseti objektů. Každé referenci přiřaďte roli: produkt, který musí zůstat rozpoznatelný, vzhled postavy, zamýšlené pozadí nebo vizuální styl. Příkladem produktového zadání je: „Obrázek A použij pro tvar lahve a etiketu. Obrázek B použij pro povrch a osvětlení. Produkt zachovej beze změny, umísti jej vedle složeného ručníku a nad ním nech volné místo pro dodaný nadpis.“
Ukotvení pomocí Google Web Search a Image Search může pro generování dodat aktuální informace a vizuální kontext. Image Search poskytuje nalezené webové obrázky jako reference; standardní webové ukotvení dodává informace o tématu. To je užitečné pro faktografickou grafiku nebo scénu, jejíž vzhled závisí na skutečném objektu. Pracovní postup vyhledávání obrázků nepodporuje získávání skutečných fotografií lidí pro tento účel. Ukotvené odpovědi v dokumentovaném postupu Googlu nesou metadata zdrojů a atribuce, proto by je aplikace měla uchovat spolu s vygenerovaným výsledkem.
Přemýšlení lze nastavit na úrovně minimal, medium a high, přičemž pro tento přesný model je výchozí medium. Pomáhá modelu před závěrečným výstupem promyslet kompozici a složitější pokyny. Průvodce obrázky popisuje průběžné kompoziční obrázky v rámci tohoto procesu; ty se liší od zamýšleného konečného výstupu. Požadované závěrečné rozvržení, poměr stran a rozlišení zvolte výslovně, místo abyste očekávali, že samotný popis v promptu určí veškerá nastavení výstupu.
Konverzační úpravy umožňují navazujícím požadavkem změnit jednu část existujícího výsledku: upravit světlo, přesunout objekt nebo přeložit popisky při zachování zbytku kompozice. Přeneste předchozí obrázek nebo interakci do dalšího kroku konverzace a uveďte požadovanou změnu i prvky, které mají zůstat zachovány. U série postav udržujte konzistentní reference vzhledu a použijte referenci pózy, pokud záleží na novém úhlu nebo složité póze. Praktické zadání revize může znít: „Zachovej produkt, popisky a rozvržení; pouze pozadí změň na teplejší šedou.“
Tabulka modelu uvádí vstupní limit 131,072 tokenů a výstupní limit 32,768 tokenů. Generování obrázků a ukotvení ve vyhledávání jsou podporovány, zatímco generování zvuku, spouštění kódu, volání funkcí, strukturované výstupy, ukládání do mezipaměti, vyhledávání v souborech, URL context a Live API nejsou pro tuto edici uvedeny jako podporované. Video může poskytnout podklady pro vygenerovaný statický obrázek; nedělá z tohoto modelu generátor videa. Google také upozorňuje, že požadavek na přesný počet obrázků nemusí vést k vytvoření právě tohoto počtu. Všechny generované obrázky obsahují vodoznak SynthID.
Pro užitečné úvodní zadání uveďte účel obrázku, námět, kompozici, osvětlení, pohled kamery, požadovaný text a tvar výstupu. Například požadujte infografiku na výšku se třemi popsanými kroky, čitelným nadpisem a určenou barevnou hierarchií a před další úpravou zkontrolujte znění a vzájemné umístění. Výsledek se může stát produktovou ilustrací, redakční grafikou nebo designovou předlohou, přičemž zvolený obrázek a jeho vysvětlující text zůstanou uchovány společně.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity google/gemini-nano-banana-2.1 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Minimální délka: 1 | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 1K, 2K, 4K | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Výchozí— |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 Maximum: 1 | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 0 Maximální počet položek: 14 | Výchozí— |
Poleprovider | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametrmaterial_types | Kontrakttext, image |
Životní cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutečně vrácené task_id nebo záznam v knihovně médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.24576 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np={'model': 'google/gemini-nano-banana-2.1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nStáhněte každý vrácený obrázek nebo uložte jeho obsah Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json\n# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.\nUložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte obsah Base64.
Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.
Uchovejte vrácené X-Client-Request-ID pro spárování záznamů. Načítejte pouze skutečně vrácené hodnoty task_id/asset_id nebo vlastní knihovnu médií; nikdy nevytvářejte URL úlohy z ID operace a nikdy znovu neodesílejte požadavek na vytvoření.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot Ultra google/gemini-nano-banana-2.1
/v1/images
google/gemini-nano-banana-2.1Gemini Nano Banana 2.1 konverzačně generuje a upravuje obrázky z textu a vizuálních materiálů. Vylepšuje vykreslování textu, rozvržení infografik a konzistenci mezi jednotlivými kroky konverzace; pro vymezené vizuální zadání nabízí výstup 1K–4K a až 14 referenčních obrázků.
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Gemini Nano Banana 2.1 je model Googlu pro generování obrázků a konverzační úpravy. Jde o aktualizaci Nano Banana 2 s vylepšením vizuálního realismu, dodržování instrukcí, vykreslování textu a konzistence postav napříč navazujícími úpravami. Tabulka vstupů zahrnuje text, obrázky, video a PDF, zatímco výstupem jsou obrázky a text. Díky tomu se hodí pro produktovou scénu, infografiku nebo vizuální sérii, která se rozvíjí prostřednictvím několika konkrétních revizí.
Model nabízí výstup 1K, 2K a 4K, přičemž výchozí je 1K. Nepřebírá možnost 0.5K z Nano Banana 2. Dokumentované poměry stran zahrnují 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 a také vysoké či panoramatické formáty 1:4, 4:1, 1:8 a 8:1. Google uvádí opravy artefaktů dlaždicování v těchto posledně uvedených širokých a vysokých formátech při 2K a 4K. Označení rozlišení představují velikostní úrovně, nikoli jeden pevný obdélník: čtvercový obrázek 4K má 4096 × 4096, zatímco dokumentovaný výstup 16:9 ve 4K má 5504 × 3072.
Text je významnou součástí vizuálního pracovního postupu. Model je navržen k vykreslování čitelného stylizovaného znění a přesnějšímu uspořádání prvků infografik. Připravte přesný nadpis, popisky a pořadí čtení a poté požadujte obrázek s tímto schváleným textem. U nabídky, diagramu nebo instruktážní grafiky pojmenujte vztah mezi popiskem a jeho vizuálním prvkem. Google doporučuje nejprve vytvořit znění a následně požádat o obrázek, aby vizuální kompozice vycházela z uzavřeného textového zadání.
Propojování referenčních obrázků podporuje až 14 obrázků. Dokumentovaný profil zahrnuje konzistenci až čtyř postav a věrnost až deseti objektů. Každé referenci přiřaďte roli: produkt, který musí zůstat rozpoznatelný, vzhled postavy, zamýšlené pozadí nebo vizuální styl. Příkladem produktového zadání je: „Obrázek A použij pro tvar lahve a etiketu. Obrázek B použij pro povrch a osvětlení. Produkt zachovej beze změny, umísti jej vedle složeného ručníku a nad ním nech volné místo pro dodaný nadpis.“
Ukotvení pomocí Google Web Search a Image Search může pro generování dodat aktuální informace a vizuální kontext. Image Search poskytuje nalezené webové obrázky jako reference; standardní webové ukotvení dodává informace o tématu. To je užitečné pro faktografickou grafiku nebo scénu, jejíž vzhled závisí na skutečném objektu. Pracovní postup vyhledávání obrázků nepodporuje získávání skutečných fotografií lidí pro tento účel. Ukotvené odpovědi v dokumentovaném postupu Googlu nesou metadata zdrojů a atribuce, proto by je aplikace měla uchovat spolu s vygenerovaným výsledkem.
Přemýšlení lze nastavit na úrovně minimal, medium a high, přičemž pro tento přesný model je výchozí medium. Pomáhá modelu před závěrečným výstupem promyslet kompozici a složitější pokyny. Průvodce obrázky popisuje průběžné kompoziční obrázky v rámci tohoto procesu; ty se liší od zamýšleného konečného výstupu. Požadované závěrečné rozvržení, poměr stran a rozlišení zvolte výslovně, místo abyste očekávali, že samotný popis v promptu určí veškerá nastavení výstupu.
Konverzační úpravy umožňují navazujícím požadavkem změnit jednu část existujícího výsledku: upravit světlo, přesunout objekt nebo přeložit popisky při zachování zbytku kompozice. Přeneste předchozí obrázek nebo interakci do dalšího kroku konverzace a uveďte požadovanou změnu i prvky, které mají zůstat zachovány. U série postav udržujte konzistentní reference vzhledu a použijte referenci pózy, pokud záleží na novém úhlu nebo složité póze. Praktické zadání revize může znít: „Zachovej produkt, popisky a rozvržení; pouze pozadí změň na teplejší šedou.“
Tabulka modelu uvádí vstupní limit 131,072 tokenů a výstupní limit 32,768 tokenů. Generování obrázků a ukotvení ve vyhledávání jsou podporovány, zatímco generování zvuku, spouštění kódu, volání funkcí, strukturované výstupy, ukládání do mezipaměti, vyhledávání v souborech, URL context a Live API nejsou pro tuto edici uvedeny jako podporované. Video může poskytnout podklady pro vygenerovaný statický obrázek; nedělá z tohoto modelu generátor videa. Google také upozorňuje, že požadavek na přesný počet obrázků nemusí vést k vytvoření právě tohoto počtu. Všechny generované obrázky obsahují vodoznak SynthID.
Pro užitečné úvodní zadání uveďte účel obrázku, námět, kompozici, osvětlení, pohled kamery, požadovaný text a tvar výstupu. Například požadujte infografiku na výšku se třemi popsanými kroky, čitelným nadpisem a určenou barevnou hierarchií a před další úpravou zkontrolujte znění a vzájemné umístění. Výsledek se může stát produktovou ilustrací, redakční grafikou nebo designovou předlohou, přičemž zvolený obrázek a jeho vysvětlující text zůstanou uchovány společně.
POST /v1/messagestextjson, sse| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity google/gemini-nano-banana-2.1 | Výchozí— |
Polemessages | Typmessage[] | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polemessages[].role | Typstring | PožadavekPovinné | Hodnoty a limity user, assistant | Výchozí— |
Polemessages[].content | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polemax_tokens | Typinteger | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polestream | Typboolean | PožadavekVolitelné | Hodnoty a limity | Výchozífalse |
Text · text UTF-8
řetězec messages[].content
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, messages, max_tokens |
Parametroptional_controls | Kontraktstream |
Parametrmaterial_types | Kontrakttext |
Parametrtext_file_material | KontraktPřečtěte skutečný dokument UTF-8 a vložte jeho text do uvedeného pole input nebo do řetězce obsahu zprávy. |
Životní cyklus: synchronous_or_streamed
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Tokeny kontextu, více než | Tokeny kontextu, do uvedené hodnoty včetně | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Tokeny kontextu, více než— | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.003 / 1K tokenů Výstup · Výstupní tokeny $0.015 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů Výstup · Tokeny výstupního obrázku $0.06 / 1K obrazových tokenů |
| KonfiguracePásmo délky požadavku 1 | Tabulka sazeb— | Tokeny kontextu, více než0 | Tokeny kontextu, do uvedené hodnoty včetněBez horní meze | Poplatek Vstup · Vstupní tokeny $0.003 / 1K tokenů Výstup · Výstupní tokeny $0.015 / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
{\n "model": "google/gemini-nano-banana-2.1",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-nano-banana-2.1', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'google/gemini-nano-banana-2.1', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON nebo SSE
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Zachovejte všechny bloky obsahu, podpisy uvažování a skutečná ID použití nástrojů. Sestavte všechny přírůstky bloků SSE; první textový blok není úplný výstup.
Zachovejte ID požadavků/odpovědí a hlavičky. Není dodána obecná URL pro načtení textové úlohy.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polemodel | Typstring |
Polecontent[] | Typtext|thinking|tool_use|other content block |
Polestop_reason | Typstring|null |
Poleusage | Typobject |
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatná povinná pole, reprezentace podkladů nebo hodnota parametru | Další krokPřed novým požadavkem na vytvoření opravte uvedená pole. |
Ailoot Ultra google/gemini-nano-banana-2.1
/v1/images
Technický příklad v angličtině
Refine an approved poster background\n\nEdit the supplied event poster. Preserve every word, the headline hierarchy, illustration placement and portrait composition. Change only the background from cool white to warm ivory, keeping dark text readable and retaining the original accent color. Do not add shapes, badges, textures or extra captions. Return the revised poster image.One edited poster with the original wording and layout preserved over a warm ivory background.Compare every word and element position against the supplied poster, then inspect text contrast.