Nano Banana 2 je model Gemini 3.1 Flash Image spoločnosti Google na natívne generovanie obrázkov a konverzačné úpravy. Jeho návrh zdôrazňuje efektívnu vizuálnu tvorbu a opakované revízie. Dokumentovaný profil API prijíma text, obrázky, video a PDF a vracia obrázok a text. Ide o samostatnú pomenovanú edíciu odlišnú od Gemini Nano Banana 2.1, nie o označenie každej neskoršej aktualizácie Nano Banana.
Veľkosti výstupu zahŕňajú 0.5K, 1K, 2K a 4K, pričom predvolená je 1K. Menšia možnosť 0.5K je špecifická pre tento profil a môže byť vhodná na úvodnú kompozíciu; vyššie úrovne poskytujú viac pixelov pre vybraný tvar výstupu. Dokumentované pomery pokrývajú štvorcové formáty a formáty na výšku a na šírku vrátane 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 s dodatočnými formátmi 1:4, 4:1, 1:8 a 8:1. Štvorcové výstupy napríklad siahajú od 512 × 512 pri 0.5K po 4096 × 4096 pri 4K. Tvar vyberte podľa zamýšľaného umiestnenia ešte pred dolaďovaním drobných detailov.
Google medzi aktualizáciami tejto edície uvádza lepšie dodržiavanie pomeru strán, vizuálnu konzistentnosť a vykresľovanie viacjazyčného textu. Pri plagáte, jedálnom lístku alebo infografike používajte presné znenie a definujte, ktoré označenie patrí ku ktorému objektu. Pri malom texte alebo dlhej pasáži karta modelu uvádza pretrvávajúce obmedzenia čitateľnosti, najmä pri 1K. Popisy držte stručné a ich relatívnu veľkosť určte výslovne; pri hustom hlavnom texte berte obrázok ako referenciu vizuálneho rozloženia a skutočné písmo dôkladne skontrolujte.
V jednom pracovnom postupe možno kombinovať až 14 referenčných obrázkov. Obrazová príručka opisuje vernosť až pri desiatich objektoch a podobnosť až pri štyroch postavách. Referencie označte a určte, čím každá prispieva. Pri produktovej scéne môže jeden obrázok určovať objekt, druhý prostredie a tretí osvetlenie. Pri sekvencii s postavou preneste predchádzajúce výstupy do ďalšieho promptu a uveďte črty, ktoré musia pretrvať pri zmene pohľadu alebo pózy.
Ukotvenie vo Web Search a Image Search môže doplniť generovanie o aktuálne informácie a získané vizuálne referencie. Image Search pridáva vizuálny kontext namiesto samotného písomného opisu výsledku vyhľadávania. Výrobca podporuje vyhľadávanie pri dokumentovaných nastaveniach uvažovania. Jeho postup obrazového vyhľadávania vylučuje skutočné fotografie ľudí ako referencie získané vyhľadávaním a spolu s ukotvenými výsledkami vracia metadáta zdrojových atribúcií; pri použití výsledku v aplikácii tieto metadáta zachovajte.
Dokumentovanými úrovňami uvažovania pre Gemini 3.1 Flash Image sú minimal a high, pričom predvolená je minimal. To sa líši od trojúrovňového profilu Nano Banana 2.1 s predvolenou úrovňou medium. Uvažovanie podporuje zložitejšiu kompozíciu a spracovanie pokynov. Model je založený na Gemini 3 Flash, ale tento vzťah z neho nerobí všeobecný model na vykonávanie kódu alebo volanie funkcií: tabuľka tejto obrazovej edície označuje tieto schopnosti ako nepodporované.
Konverzačné úpravy podporujú zmenu dodaného obrázka alebo dolaďovanie predchádzajúceho generovania. Konkrétne zadanie môže znieť: „Zachovajte tvar fľaše, text etikety a uhol kamery. Nahraďte pozadie svetlým kamenným povrchom a pridajte jemnejšie tiene.“ Zachovávané prvky opisujte rovnako dôsledne ako menené. Karta modelu upozorňuje, že konzistentnosť postáv, rozlišovanie ľavej a pravej strany a úpravy podľa náčrtkov môžu zostať nedokonalé, preto tieto detaily porovnajte ešte pred pokračovaním vizuálnej sekvencie.
Tabuľka modelu API uvádza 131 072 vstupných a 32 768 výstupných tokenov. Podporuje generovanie obrázkov, ukotvenie vo vyhľadávaní, uvažovanie a dávkové spracovanie, zatiaľ čo generovanie zvuku, ukladanie do vyrovnávacej pamäte, štruktúrované výstupy, vyhľadávanie v súboroch, Live API a kontext URL sú nepodporované. Obrazový pracovný postup neprijíma zvukový vstup. Video alebo PDF môžu v tomto profile API poskytnúť podklady pre úlohu s nehybným obrázkom; výstupom zostáva obrázok a text. Generované obrázky obsahujú SynthID a požadovaný počet obrázkov sa nie vždy dodrží presne.
Pri praktickej infografike poskytnite schválené označenia, zamýšľané publikum, poradie čítania, referenčný materiál a cieľový pomer strán. Požiadajte o jedno jasné vizuálne vysvetlenie a v ďalšom ťahu opravte znenie alebo rozostupy pri zachovaní vytvorenej kompozície. Pri produktovej makete určte geometriu, povrch, svetlo a vizuálne detaily definujúce produkt. Užitočným výsledkom je obrázok so súvisiacim textom, ktorý možno skontrolovať, vybrať a dolaďovať v riadenej sekvencii.
", "aboutText": "Nano Banana 2 je model Gemini 3.1 Flash Image spoločnosti Google na natívne generovanie obrázkov a konverzačné úpravy. Jeho návrh zdôrazňuje efektívnu vizuálnu tvorbu a opakované revízie. Dokumentovaný profil API prijíma text, obrázky, video a PDF a vracia obrázok a text. Ide o samostatnú pomenovanú edíciu odlišnú od Gemini Nano Banana 2.1, nie o označenie každej neskoršej aktualizácie Nano Banana.\n\nVeľkosti výstupu zahŕňajú 0.5K, 1K, 2K a 4K, pričom predvolená je 1K. Menšia možnosť 0.5K je špecifická pre tento profil a môže byť vhodná na úvodnú kompozíciu; vyššie úrovne poskytujú viac pixelov pre vybraný tvar výstupu. Dokumentované pomery pokrývajú štvorcové formáty a formáty na výšku a na šírku vrátane 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 s dodatočnými formátmi 1:4, 4:1, 1:8 a 8:1. Štvorcové výstupy napríklad siahajú od 512 × 512 pri 0.5K po 4096 × 4096 pri 4K. Tvar vyberte podľa zamýšľaného umiestnenia ešte pred dolaďovaním drobných detailov.\n\nGoogle medzi aktualizáciami tejto edície uvádza lepšie dodržiavanie pomeru strán, vizuálnu konzistentnosť a vykresľovanie viacjazyčného textu. Pri plagáte, jedálnom lístku alebo infografike používajte presné znenie a definujte, ktoré označenie patrí ku ktorému objektu. Pri malom texte alebo dlhej pasáži karta modelu uvádza pretrvávajúce obmedzenia čitateľnosti, najmä pri 1K. Popisy držte stručné a ich relatívnu veľkosť určte výslovne; pri hustom hlavnom texte berte obrázok ako referenciu vizuálneho rozloženia a skutočné písmo dôkladne skontrolujte.\n\nV jednom pracovnom postupe možno kombinovať až 14 referenčných obrázkov. Obrazová príručka opisuje vernosť až pri desiatich objektoch a podobnosť až pri štyroch postavách. Referencie označte a určte, čím každá prispieva. Pri produktovej scéne môže jeden obrázok určovať objekt, druhý prostredie a tretí osvetlenie. Pri sekvencii s postavou preneste predchádzajúce výstupy do ďalšieho promptu a uveďte črty, ktoré musia pretrvať pri zmene pohľadu alebo pózy.\n\nUkotvenie vo Web Search a Image Search môže doplniť generovanie o aktuálne informácie a získané vizuálne referencie. Image Search pridáva vizuálny kontext namiesto samotného písomného opisu výsledku vyhľadávania. Výrobca podporuje vyhľadávanie pri dokumentovaných nastaveniach uvažovania. Jeho postup obrazového vyhľadávania vylučuje skutočné fotografie ľudí ako referencie získané vyhľadávaním a spolu s ukotvenými výsledkami vracia metadáta zdrojových atribúcií; pri použití výsledku v aplikácii tieto metadáta zachovajte.\n\nDokumentovanými úrovňami uvažovania pre Gemini 3.1 Flash Image sú minimal a high, pričom predvolená je minimal. To sa líši od trojúrovňového profilu Nano Banana 2.1 s predvolenou úrovňou medium. Uvažovanie podporuje zložitejšiu kompozíciu a spracovanie pokynov. Model je založený na Gemini 3 Flash, ale tento vzťah z neho nerobí všeobecný model na vykonávanie kódu alebo volanie funkcií: tabuľka tejto obrazovej edície označuje tieto schopnosti ako nepodporované.\n\nKonverzačné úpravy podporujú zmenu dodaného obrázka alebo dolaďovanie predchádzajúceho generovania. Konkrétne zadanie môže znieť: „Zachovajte tvar fľaše, text etikety a uhol kamery. Nahraďte pozadie svetlým kamenným povrchom a pridajte jemnejšie tiene.“ Zachovávané prvky opisujte rovnako dôsledne ako menené. Karta modelu upozorňuje, že konzistentnosť postáv, rozlišovanie ľavej a pravej strany a úpravy podľa náčrtkov môžu zostať nedokonalé, preto tieto detaily porovnajte ešte pred pokračovaním vizuálnej sekvencie.\n\nTabuľka modelu API uvádza 131 072 vstupných a 32 768 výstupných tokenov. Podporuje generovanie obrázkov, ukotvenie vo vyhľadávaní, uvažovanie a dávkové spracovanie, zatiaľ čo generovanie zvuku, ukladanie do vyrovnávacej pamäte, štruktúrované výstupy, vyhľadávanie v súboroch, Live API a kontext URL sú nepodporované. Obrazový pracovný postup neprijíma zvukový vstup. Video alebo PDF môžu v tomto profile API poskytnúť podklady pre úlohu s nehybným obrázkom; výstupom zostáva obrázok a text. Generované obrázky obsahujú SynthID a požadovaný počet obrázkov sa nie vždy dodrží presne.\n\nPri praktickej infografike poskytnite schválené označenia, zamýšľané publikum, poradie čítania, referenčný materiál a cieľový pomer strán. Požiadajte o jedno jasné vizuálne vysvetlenie a v ďalšom ťahu opravte znenie alebo rozostupy pri zachovaní vytvorenej kompozície. Pri produktovej makete určte geometriu, povrch, svetlo a vizuálne detaily definujúce produkt. Užitočným výsledkom je obrázok so súvisiacim textom, ktorý možno skontrolovať, vybrať a dolaďovať v riadenej sekvencii.", "editorialOverlay": { "copy_fields": { "practical_html": "Technický príklad v angličtine
Create a simple bicycle-care infographic\n\nCreate one portrait infographic teaching three bicycle checks before a short ride: tires, brakes and chain. Use three large illustrated steps in that order, a warm ivory background and dark green accents. Include only these headings: 'TIRES', 'BRAKES', 'CHAIN'. Leave generous space around each heading and keep the illustrations clearly separated.One portrait image with three ordered illustrated steps and the three exact, readable headings.Inspect the rendered image for heading spelling, order and clear separation of the three checks.gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) generuje a upravuje obrázky v konverzácii. Podporuje textové a vizuálne zdroje, výstup 0.5K–4K, kompozíciu s referenčnými obrázkami a ukotvenie vo vyhľadávaní pri produktových scénach, infografikách a iteratívnej vizuálnej práci.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Nano Banana 2 je model Gemini 3.1 Flash Image spoločnosti Google na natívne generovanie obrázkov a konverzačné úpravy. Jeho návrh zdôrazňuje efektívnu vizuálnu tvorbu a opakované revízie. Dokumentovaný profil API prijíma text, obrázky, video a PDF a vracia obrázok a text. Ide o samostatnú pomenovanú edíciu odlišnú od Gemini Nano Banana 2.1, nie o označenie každej neskoršej aktualizácie Nano Banana.
Veľkosti výstupu zahŕňajú 0.5K, 1K, 2K a 4K, pričom predvolená je 1K. Menšia možnosť 0.5K je špecifická pre tento profil a môže byť vhodná na úvodnú kompozíciu; vyššie úrovne poskytujú viac pixelov pre vybraný tvar výstupu. Dokumentované pomery pokrývajú štvorcové formáty a formáty na výšku a na šírku vrátane 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 s dodatočnými formátmi 1:4, 4:1, 1:8 a 8:1. Štvorcové výstupy napríklad siahajú od 512 × 512 pri 0.5K po 4096 × 4096 pri 4K. Tvar vyberte podľa zamýšľaného umiestnenia ešte pred dolaďovaním drobných detailov.
Google medzi aktualizáciami tejto edície uvádza lepšie dodržiavanie pomeru strán, vizuálnu konzistentnosť a vykresľovanie viacjazyčného textu. Pri plagáte, jedálnom lístku alebo infografike používajte presné znenie a definujte, ktoré označenie patrí ku ktorému objektu. Pri malom texte alebo dlhej pasáži karta modelu uvádza pretrvávajúce obmedzenia čitateľnosti, najmä pri 1K. Popisy držte stručné a ich relatívnu veľkosť určte výslovne; pri hustom hlavnom texte berte obrázok ako referenciu vizuálneho rozloženia a skutočné písmo dôkladne skontrolujte.
V jednom pracovnom postupe možno kombinovať až 14 referenčných obrázkov. Obrazová príručka opisuje vernosť až pri desiatich objektoch a podobnosť až pri štyroch postavách. Referencie označte a určte, čím každá prispieva. Pri produktovej scéne môže jeden obrázok určovať objekt, druhý prostredie a tretí osvetlenie. Pri sekvencii s postavou preneste predchádzajúce výstupy do ďalšieho promptu a uveďte črty, ktoré musia pretrvať pri zmene pohľadu alebo pózy.
Ukotvenie vo Web Search a Image Search môže doplniť generovanie o aktuálne informácie a získané vizuálne referencie. Image Search pridáva vizuálny kontext namiesto samotného písomného opisu výsledku vyhľadávania. Výrobca podporuje vyhľadávanie pri dokumentovaných nastaveniach uvažovania. Jeho postup obrazového vyhľadávania vylučuje skutočné fotografie ľudí ako referencie získané vyhľadávaním a spolu s ukotvenými výsledkami vracia metadáta zdrojových atribúcií; pri použití výsledku v aplikácii tieto metadáta zachovajte.
Dokumentovanými úrovňami uvažovania pre Gemini 3.1 Flash Image sú minimal a high, pričom predvolená je minimal. To sa líši od trojúrovňového profilu Nano Banana 2.1 s predvolenou úrovňou medium. Uvažovanie podporuje zložitejšiu kompozíciu a spracovanie pokynov. Model je založený na Gemini 3 Flash, ale tento vzťah z neho nerobí všeobecný model na vykonávanie kódu alebo volanie funkcií: tabuľka tejto obrazovej edície označuje tieto schopnosti ako nepodporované.
Konverzačné úpravy podporujú zmenu dodaného obrázka alebo dolaďovanie predchádzajúceho generovania. Konkrétne zadanie môže znieť: „Zachovajte tvar fľaše, text etikety a uhol kamery. Nahraďte pozadie svetlým kamenným povrchom a pridajte jemnejšie tiene.“ Zachovávané prvky opisujte rovnako dôsledne ako menené. Karta modelu upozorňuje, že konzistentnosť postáv, rozlišovanie ľavej a pravej strany a úpravy podľa náčrtkov môžu zostať nedokonalé, preto tieto detaily porovnajte ešte pred pokračovaním vizuálnej sekvencie.
Tabuľka modelu API uvádza 131 072 vstupných a 32 768 výstupných tokenov. Podporuje generovanie obrázkov, ukotvenie vo vyhľadávaní, uvažovanie a dávkové spracovanie, zatiaľ čo generovanie zvuku, ukladanie do vyrovnávacej pamäte, štruktúrované výstupy, vyhľadávanie v súboroch, Live API a kontext URL sú nepodporované. Obrazový pracovný postup neprijíma zvukový vstup. Video alebo PDF môžu v tomto profile API poskytnúť podklady pre úlohu s nehybným obrázkom; výstupom zostáva obrázok a text. Generované obrázky obsahujú SynthID a požadovaný počet obrázkov sa nie vždy dodrží presne.
Pri praktickej infografike poskytnite schválené označenia, zamýšľané publikum, poradie čítania, referenčný materiál a cieľový pomer strán. Požiadajte o jedno jasné vizuálne vysvetlenie a v ďalšom ťahu opravte znenie alebo rozostupy pri zachovaní vytvorenej kompozície. Pri produktovej makete určte geometriu, povrch, svetlo a vizuálne detaily definujúce produkt. Užitočným výsledkom je obrázok so súvisiacim textom, ktorý možno skontrolovať, vybrať a dolaďovať v riadenej sekvencii.
POST /v1/images/generationstextimage, text| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity gemini-3.1-flash-image | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 | Predvolené1 |
Poleresponse_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity url, b64_json | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polequality | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polebackground | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleoutput_format | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleoutput_compression | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polemoderation | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleinput_fidelity | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polestyle | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polepartial_images | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Z textu na obrázok · Povinné: prompt
| Parameter | Špecifikácia |
|---|---|
Parametermaterial_types | Špecifikáciatext |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional_controls | Špecifikácianull |
Parametercontent_type | Špecifikáciaapplication/json |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Štruktúry metód a ID sú presné; možnosti dodávateľa sa posudzujú oddelene od prijatia požiadavky.
POST /v1/images/generationsAiloot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
| Konfigurácia | Sadzobník | Poplatok |
|---|---|---|
| KonfiguráciaUltra | SadzobníkZákladná sadzba | Poplatok Vstup · Vstupné tokeny $0.0010000 / 1K tokenov Výstup · Výstupné tokeny $0.006000 / 1K tokenov Výstup · výstup obrázka $0.12000 / 1K tokenov Výstup · vyhľadávanie na webe $0.028 za vyhľadávanie na webe |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "gemini-3.1-flash-image", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\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\nfrom openai import OpenAI\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")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'gemini-3.1-flash-image', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "gemini-3.1-flash-image", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nStiahnite každý vrátený obrázok alebo 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}Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uložte každú dátovú položku. Dekódujte každé b64_json alebo stiahnite obsah z každej vrátenej podpísanej URL. Príponu názvu súboru vyberte podľa skutočného typu MIME/bajtov.
Ak je potrebné skontrolovať výsledok generovania alebo úpravy obrázka, uchovajte pôvodné operation_id/X-Client-Request-ID a vrátené informácie o výsledku. Existujúce vlastné výsledky obnovte cez knižnicu médií pomocou skutočných hodnôt task_id alebo asset_id. Požiadavku na generovanie/úpravu znova neodosielajte ani nevytvárajte URL na priebežné zisťovanie stavu z operation_id.
| Pole | Typ |
|---|---|
Polecreated | Typinteger |
Poledata[].url | Typstring |
Poledata[].b64_json | Typbase64 string |
Poleusage | Typobject |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
google/gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) generuje a upravuje obrázky v konverzácii. Podporuje textové a vizuálne zdroje, výstup 0.5K–4K, kompozíciu s referenčnými obrázkami a ukotvenie vo vyhľadávaní pri produktových scénach, infografikách a iteratívnej vizuálnej práci.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Nano Banana 2 je model Gemini 3.1 Flash Image spoločnosti Google na natívne generovanie obrázkov a konverzačné úpravy. Jeho návrh zdôrazňuje efektívnu vizuálnu tvorbu a opakované revízie. Dokumentovaný profil API prijíma text, obrázky, video a PDF a vracia obrázok a text. Ide o samostatnú pomenovanú edíciu odlišnú od Gemini Nano Banana 2.1, nie o označenie každej neskoršej aktualizácie Nano Banana.
Veľkosti výstupu zahŕňajú 0.5K, 1K, 2K a 4K, pričom predvolená je 1K. Menšia možnosť 0.5K je špecifická pre tento profil a môže byť vhodná na úvodnú kompozíciu; vyššie úrovne poskytujú viac pixelov pre vybraný tvar výstupu. Dokumentované pomery pokrývajú štvorcové formáty a formáty na výšku a na šírku vrátane 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 s dodatočnými formátmi 1:4, 4:1, 1:8 a 8:1. Štvorcové výstupy napríklad siahajú od 512 × 512 pri 0.5K po 4096 × 4096 pri 4K. Tvar vyberte podľa zamýšľaného umiestnenia ešte pred dolaďovaním drobných detailov.
Google medzi aktualizáciami tejto edície uvádza lepšie dodržiavanie pomeru strán, vizuálnu konzistentnosť a vykresľovanie viacjazyčného textu. Pri plagáte, jedálnom lístku alebo infografike používajte presné znenie a definujte, ktoré označenie patrí ku ktorému objektu. Pri malom texte alebo dlhej pasáži karta modelu uvádza pretrvávajúce obmedzenia čitateľnosti, najmä pri 1K. Popisy držte stručné a ich relatívnu veľkosť určte výslovne; pri hustom hlavnom texte berte obrázok ako referenciu vizuálneho rozloženia a skutočné písmo dôkladne skontrolujte.
V jednom pracovnom postupe možno kombinovať až 14 referenčných obrázkov. Obrazová príručka opisuje vernosť až pri desiatich objektoch a podobnosť až pri štyroch postavách. Referencie označte a určte, čím každá prispieva. Pri produktovej scéne môže jeden obrázok určovať objekt, druhý prostredie a tretí osvetlenie. Pri sekvencii s postavou preneste predchádzajúce výstupy do ďalšieho promptu a uveďte črty, ktoré musia pretrvať pri zmene pohľadu alebo pózy.
Ukotvenie vo Web Search a Image Search môže doplniť generovanie o aktuálne informácie a získané vizuálne referencie. Image Search pridáva vizuálny kontext namiesto samotného písomného opisu výsledku vyhľadávania. Výrobca podporuje vyhľadávanie pri dokumentovaných nastaveniach uvažovania. Jeho postup obrazového vyhľadávania vylučuje skutočné fotografie ľudí ako referencie získané vyhľadávaním a spolu s ukotvenými výsledkami vracia metadáta zdrojových atribúcií; pri použití výsledku v aplikácii tieto metadáta zachovajte.
Dokumentovanými úrovňami uvažovania pre Gemini 3.1 Flash Image sú minimal a high, pričom predvolená je minimal. To sa líši od trojúrovňového profilu Nano Banana 2.1 s predvolenou úrovňou medium. Uvažovanie podporuje zložitejšiu kompozíciu a spracovanie pokynov. Model je založený na Gemini 3 Flash, ale tento vzťah z neho nerobí všeobecný model na vykonávanie kódu alebo volanie funkcií: tabuľka tejto obrazovej edície označuje tieto schopnosti ako nepodporované.
Konverzačné úpravy podporujú zmenu dodaného obrázka alebo dolaďovanie predchádzajúceho generovania. Konkrétne zadanie môže znieť: „Zachovajte tvar fľaše, text etikety a uhol kamery. Nahraďte pozadie svetlým kamenným povrchom a pridajte jemnejšie tiene.“ Zachovávané prvky opisujte rovnako dôsledne ako menené. Karta modelu upozorňuje, že konzistentnosť postáv, rozlišovanie ľavej a pravej strany a úpravy podľa náčrtkov môžu zostať nedokonalé, preto tieto detaily porovnajte ešte pred pokračovaním vizuálnej sekvencie.
Tabuľka modelu API uvádza 131 072 vstupných a 32 768 výstupných tokenov. Podporuje generovanie obrázkov, ukotvenie vo vyhľadávaní, uvažovanie a dávkové spracovanie, zatiaľ čo generovanie zvuku, ukladanie do vyrovnávacej pamäte, štruktúrované výstupy, vyhľadávanie v súboroch, Live API a kontext URL sú nepodporované. Obrazový pracovný postup neprijíma zvukový vstup. Video alebo PDF môžu v tomto profile API poskytnúť podklady pre úlohu s nehybným obrázkom; výstupom zostáva obrázok a text. Generované obrázky obsahujú SynthID a požadovaný počet obrázkov sa nie vždy dodrží presne.
Pri praktickej infografike poskytnite schválené označenia, zamýšľané publikum, poradie čítania, referenčný materiál a cieľový pomer strán. Požiadajte o jedno jasné vizuálne vysvetlenie a v ďalšom ťahu opravte znenie alebo rozostupy pri zachovaní vytvorenej kompozície. Pri produktovej makete určte geometriu, povrch, svetlo a vizuálne detaily definujúce produkt. Užitočným výsledkom je obrázok so súvisiacim textom, ktorý možno skontrolovať, vybrať a dolaďovať v riadenej sekvencii.
POST /v1/chat/completionstexttext| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/gemini-3.1-flash-image | Predvolené— |
Polemessages | Typmessage[] | PožiadavkaPovinné | Hodnoty a limity Minimálny počet položiek: 1 | Predvolené— |
Polemessages[].role | Typstring | PožiadavkaPovinné | Hodnoty a limity Príklady: system, user, assistant, tool, function Podmienky: Tieto roly sú výslovne zastúpené typmi kompatibility v zdrojovom kóde; presný súbor rolí zostáva závislý od modelu. Závisí od modelu | Predvolené— |
Polemessages[].content | Typstring|content_part[]|null | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polemessages[].tool_calls | Typtool_call[] | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polemessages[].tool_call_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Platí, keď: role=tool; použite skutočne vrátené ID | Predvolené— |
Polemessages[].name | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polemessages[].reasoning_content | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Platí, keď: Posielajte späť skutočne vrátené uvažovanie, ak ho tento model používa | Predvolené— |
Polemessages[].reasoning_details | Typobject|array | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polemax_tokens | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Závisí od modelu | Predvolené— |
Polemax_completion_tokens | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Závisí od modelu | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Polestream_options.include_usage | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poletemperature | Typnumber | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poletop_p | Typnumber | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polestop | Typstring|string[] | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poletools | Typfunction_tool[] | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poletools[].type | Typstring | PožiadavkaVoliteľné | Hodnoty a limity function Závisí od modelu | Predvolené— |
Poletools[].function.name | Typstring | PožiadavkaPovinné | Hodnoty a limity Platí, keď: poskytnutý nástroj typu funkcia | Predvolené— |
Poletools[].function.description | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletools[].function.parameters | TypJSON_schema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletool_choice | Typstring|object | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleparallel_tool_calls | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleresponse_format | Typobject | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polereasoning_effort | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polereasoning | Typobject | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleservice_tier | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleinstructions | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Pole kompatibility | Predvolené— |
Polefunctions | Typfunction[] | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polefunction_call | Typstring|object | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Poleprompt_cache_options | Typobject | PožiadavkaVoliteľné | Hodnoty a limity Závisí od modelu | Predvolené— |
Polemodalities | Typstring[] | PožiadavkaVoliteľné | Hodnoty a limity text | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: provider.options sa na tejto textovej trase Ultra odmieta | Predvolené— |
Polecache_control.ttl | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Hodnota 1h sa v skutočne používaných poliach cache promptov odmieta | Predvolené— |
Text · Text UTF8
messages[].content
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, messages |
Parametermaterial_types | Špecifikáciatext |
Parametermessages | Špecifikáciapole správ so štruktúrou role/content |
Parameterfile_material | Špecifikáciaskutočný dokument UTF-8 vložený ako doslovný text; ID súboru sa neodvodzuje |
Parameteroptional_controls | Špecifikáciastream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Špecifikáciazávisí od modelu; používateľské nástroje typu funkcia sa líšia od nástrojov prevádzkovaných službou |
Parameteroutput_modalities | Špecifikáciatext |
Parameterhosted_operations | Špecifikáciafalse |
Parametermultimodal_input_binding | Špecifikácianull |
Životný cyklus: synchronous_or_streamed
Pošlite presné ID modelu spolu s messages.
Dĺžka kontextu nie je horná hranica výstupu.
Textový súbor môže poskytnúť doslovný text; obrazové a zvukové vstupy a vstupy so súborovými objektmi potrebujú presné naviazanie.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Počet tokenov kontextu väčší než | Tokeny kontextu, najviac (vrátane hranice) | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Počet tokenov kontextu väčší než— | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.001 / 1K tokenov Výstup · Výstupné tokeny $0.006 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov Výstup · Tokeny výstupného obrázka $0.12 / 1K obrazových tokenov |
| KonfiguráciaPásmo dĺžky požiadavky 1 | Sadzobník— | Počet tokenov kontextu väčší než0 | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.001 / 1K tokenov Výstup · Výstupné tokeny $0.006 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaGoogle: Nano Banana 2 (Gemini 3.1 Flash Image) · Predvolená konfigurácia | Podmienky účtovaniaPredvolená konfigurácia | Poplatok Vstup · Vstupné tokeny 0,001 USD / 1K tokenov Výstup · Výstupné tokeny 0,006 USD / 1K tokenov Výstup · Výstupný obrázok 0,12 USD / 1K tokenov Výstup · Vyhľadávanie na webe 0,028 USD za vyhľadávanie |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
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-3.1-flash-image", "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-3.1-flash-image',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-3.1-flash-image',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 alebo SSE
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachovajte každý variant odpovede a jeho obsah, volania nástrojov a uvažovanie. V SSE zostavujte čiastkové zmeny podľa indexu variantu/nástroja a zachovajte konečný dôvod ukončenia aj údaje o spotrebe.
Zachovajte ID požiadaviek/odpovedí aj hlavičky. Všeobecná URL na načítanie textovej úlohy nie je poskytnutá.
| 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 |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
google/gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) generuje a upravuje obrázky v konverzácii. Podporuje textové a vizuálne zdroje, výstup 0.5K–4K, kompozíciu s referenčnými obrázkami a ukotvenie vo vyhľadávaní pri produktových scénach, infografikách a iteratívnej vizuálnej práci.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Nano Banana 2 je model Gemini 3.1 Flash Image spoločnosti Google na natívne generovanie obrázkov a konverzačné úpravy. Jeho návrh zdôrazňuje efektívnu vizuálnu tvorbu a opakované revízie. Dokumentovaný profil API prijíma text, obrázky, video a PDF a vracia obrázok a text. Ide o samostatnú pomenovanú edíciu odlišnú od Gemini Nano Banana 2.1, nie o označenie každej neskoršej aktualizácie Nano Banana.
Veľkosti výstupu zahŕňajú 0.5K, 1K, 2K a 4K, pričom predvolená je 1K. Menšia možnosť 0.5K je špecifická pre tento profil a môže byť vhodná na úvodnú kompozíciu; vyššie úrovne poskytujú viac pixelov pre vybraný tvar výstupu. Dokumentované pomery pokrývajú štvorcové formáty a formáty na výšku a na šírku vrátane 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 s dodatočnými formátmi 1:4, 4:1, 1:8 a 8:1. Štvorcové výstupy napríklad siahajú od 512 × 512 pri 0.5K po 4096 × 4096 pri 4K. Tvar vyberte podľa zamýšľaného umiestnenia ešte pred dolaďovaním drobných detailov.
Google medzi aktualizáciami tejto edície uvádza lepšie dodržiavanie pomeru strán, vizuálnu konzistentnosť a vykresľovanie viacjazyčného textu. Pri plagáte, jedálnom lístku alebo infografike používajte presné znenie a definujte, ktoré označenie patrí ku ktorému objektu. Pri malom texte alebo dlhej pasáži karta modelu uvádza pretrvávajúce obmedzenia čitateľnosti, najmä pri 1K. Popisy držte stručné a ich relatívnu veľkosť určte výslovne; pri hustom hlavnom texte berte obrázok ako referenciu vizuálneho rozloženia a skutočné písmo dôkladne skontrolujte.
V jednom pracovnom postupe možno kombinovať až 14 referenčných obrázkov. Obrazová príručka opisuje vernosť až pri desiatich objektoch a podobnosť až pri štyroch postavách. Referencie označte a určte, čím každá prispieva. Pri produktovej scéne môže jeden obrázok určovať objekt, druhý prostredie a tretí osvetlenie. Pri sekvencii s postavou preneste predchádzajúce výstupy do ďalšieho promptu a uveďte črty, ktoré musia pretrvať pri zmene pohľadu alebo pózy.
Ukotvenie vo Web Search a Image Search môže doplniť generovanie o aktuálne informácie a získané vizuálne referencie. Image Search pridáva vizuálny kontext namiesto samotného písomného opisu výsledku vyhľadávania. Výrobca podporuje vyhľadávanie pri dokumentovaných nastaveniach uvažovania. Jeho postup obrazového vyhľadávania vylučuje skutočné fotografie ľudí ako referencie získané vyhľadávaním a spolu s ukotvenými výsledkami vracia metadáta zdrojových atribúcií; pri použití výsledku v aplikácii tieto metadáta zachovajte.
Dokumentovanými úrovňami uvažovania pre Gemini 3.1 Flash Image sú minimal a high, pričom predvolená je minimal. To sa líši od trojúrovňového profilu Nano Banana 2.1 s predvolenou úrovňou medium. Uvažovanie podporuje zložitejšiu kompozíciu a spracovanie pokynov. Model je založený na Gemini 3 Flash, ale tento vzťah z neho nerobí všeobecný model na vykonávanie kódu alebo volanie funkcií: tabuľka tejto obrazovej edície označuje tieto schopnosti ako nepodporované.
Konverzačné úpravy podporujú zmenu dodaného obrázka alebo dolaďovanie predchádzajúceho generovania. Konkrétne zadanie môže znieť: „Zachovajte tvar fľaše, text etikety a uhol kamery. Nahraďte pozadie svetlým kamenným povrchom a pridajte jemnejšie tiene.“ Zachovávané prvky opisujte rovnako dôsledne ako menené. Karta modelu upozorňuje, že konzistentnosť postáv, rozlišovanie ľavej a pravej strany a úpravy podľa náčrtkov môžu zostať nedokonalé, preto tieto detaily porovnajte ešte pred pokračovaním vizuálnej sekvencie.
Tabuľka modelu API uvádza 131 072 vstupných a 32 768 výstupných tokenov. Podporuje generovanie obrázkov, ukotvenie vo vyhľadávaní, uvažovanie a dávkové spracovanie, zatiaľ čo generovanie zvuku, ukladanie do vyrovnávacej pamäte, štruktúrované výstupy, vyhľadávanie v súboroch, Live API a kontext URL sú nepodporované. Obrazový pracovný postup neprijíma zvukový vstup. Video alebo PDF môžu v tomto profile API poskytnúť podklady pre úlohu s nehybným obrázkom; výstupom zostáva obrázok a text. Generované obrázky obsahujú SynthID a požadovaný počet obrázkov sa nie vždy dodrží presne.
Pri praktickej infografike poskytnite schválené označenia, zamýšľané publikum, poradie čítania, referenčný materiál a cieľový pomer strán. Požiadajte o jedno jasné vizuálne vysvetlenie a v ďalšom ťahu opravte znenie alebo rozostupy pri zachovaní vytvorenej kompozície. Pri produktovej makete určte geometriu, povrch, svetlo a vizuálne detaily definujúce produkt. Užitočným výsledkom je obrázok so súvisiacim textom, ktorý možno skontrolovať, vybrať a dolaďovať v riadenej sekvencii.
POST /v1/images/generationstext, imageimage| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/gemini-3.1-flash-image | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Minimálna dĺžka: 1 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 512, 1K, 2K, 4K | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | 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 | Predvolené— |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 Maximum: 1 | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 0 Maximálny počet položiek: 14 | Predvolené— |
Poleprovider | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parametermaterial_types | Špecifikáciatext, image |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · skutočne vrátené task_id alebo záznam v knižnici médií
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.49152 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
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-3.1-flash-image', '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\nStiahnite každý vrátený obrázok alebo 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ázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Uchovajte úplnú odpoveď a hlavičky, všetky skutočné výstupy, pôvodné vrátené identifikátory a všetky polia s údajmi o spotrebe. Obnovte pôvodnú operáciu bez opätovného odoslania požiadavky na vytvorenie.
Uchovajte vrátené X-Client-Request-ID na zosúladenie záznamov. Čítajte iba skutočne vrátené hodnoty task_id/asset_id alebo vlastnú knižnicu médií; nikdy nevytvárajte URL úlohy z ID operácie a nikdy znova neodosielajte požiadavku na vytvorenie.
| Pole | Typ |
|---|---|
Polecreated | Typ |
Poledata[].url | Typ |
Poledata[].b64_json | Typ |
Poleusage | Typ |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
google/gemini-3.1-flash-imageNano Banana 2 (Gemini 3.1 Flash Image) generuje a upravuje obrázky v konverzácii. Podporuje textové a vizuálne zdroje, výstup 0.5K–4K, kompozíciu s referenčnými obrázkami a ukotvenie vo vyhľadávaní pri produktových scénach, infografikách a iteratívnej vizuálnej práci.
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Nano Banana 2 je model Gemini 3.1 Flash Image spoločnosti Google na natívne generovanie obrázkov a konverzačné úpravy. Jeho návrh zdôrazňuje efektívnu vizuálnu tvorbu a opakované revízie. Dokumentovaný profil API prijíma text, obrázky, video a PDF a vracia obrázok a text. Ide o samostatnú pomenovanú edíciu odlišnú od Gemini Nano Banana 2.1, nie o označenie každej neskoršej aktualizácie Nano Banana.
Veľkosti výstupu zahŕňajú 0.5K, 1K, 2K a 4K, pričom predvolená je 1K. Menšia možnosť 0.5K je špecifická pre tento profil a môže byť vhodná na úvodnú kompozíciu; vyššie úrovne poskytujú viac pixelov pre vybraný tvar výstupu. Dokumentované pomery pokrývajú štvorcové formáty a formáty na výšku a na šírku vrátane 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 a 21:9 s dodatočnými formátmi 1:4, 4:1, 1:8 a 8:1. Štvorcové výstupy napríklad siahajú od 512 × 512 pri 0.5K po 4096 × 4096 pri 4K. Tvar vyberte podľa zamýšľaného umiestnenia ešte pred dolaďovaním drobných detailov.
Google medzi aktualizáciami tejto edície uvádza lepšie dodržiavanie pomeru strán, vizuálnu konzistentnosť a vykresľovanie viacjazyčného textu. Pri plagáte, jedálnom lístku alebo infografike používajte presné znenie a definujte, ktoré označenie patrí ku ktorému objektu. Pri malom texte alebo dlhej pasáži karta modelu uvádza pretrvávajúce obmedzenia čitateľnosti, najmä pri 1K. Popisy držte stručné a ich relatívnu veľkosť určte výslovne; pri hustom hlavnom texte berte obrázok ako referenciu vizuálneho rozloženia a skutočné písmo dôkladne skontrolujte.
V jednom pracovnom postupe možno kombinovať až 14 referenčných obrázkov. Obrazová príručka opisuje vernosť až pri desiatich objektoch a podobnosť až pri štyroch postavách. Referencie označte a určte, čím každá prispieva. Pri produktovej scéne môže jeden obrázok určovať objekt, druhý prostredie a tretí osvetlenie. Pri sekvencii s postavou preneste predchádzajúce výstupy do ďalšieho promptu a uveďte črty, ktoré musia pretrvať pri zmene pohľadu alebo pózy.
Ukotvenie vo Web Search a Image Search môže doplniť generovanie o aktuálne informácie a získané vizuálne referencie. Image Search pridáva vizuálny kontext namiesto samotného písomného opisu výsledku vyhľadávania. Výrobca podporuje vyhľadávanie pri dokumentovaných nastaveniach uvažovania. Jeho postup obrazového vyhľadávania vylučuje skutočné fotografie ľudí ako referencie získané vyhľadávaním a spolu s ukotvenými výsledkami vracia metadáta zdrojových atribúcií; pri použití výsledku v aplikácii tieto metadáta zachovajte.
Dokumentovanými úrovňami uvažovania pre Gemini 3.1 Flash Image sú minimal a high, pričom predvolená je minimal. To sa líši od trojúrovňového profilu Nano Banana 2.1 s predvolenou úrovňou medium. Uvažovanie podporuje zložitejšiu kompozíciu a spracovanie pokynov. Model je založený na Gemini 3 Flash, ale tento vzťah z neho nerobí všeobecný model na vykonávanie kódu alebo volanie funkcií: tabuľka tejto obrazovej edície označuje tieto schopnosti ako nepodporované.
Konverzačné úpravy podporujú zmenu dodaného obrázka alebo dolaďovanie predchádzajúceho generovania. Konkrétne zadanie môže znieť: „Zachovajte tvar fľaše, text etikety a uhol kamery. Nahraďte pozadie svetlým kamenným povrchom a pridajte jemnejšie tiene.“ Zachovávané prvky opisujte rovnako dôsledne ako menené. Karta modelu upozorňuje, že konzistentnosť postáv, rozlišovanie ľavej a pravej strany a úpravy podľa náčrtkov môžu zostať nedokonalé, preto tieto detaily porovnajte ešte pred pokračovaním vizuálnej sekvencie.
Tabuľka modelu API uvádza 131 072 vstupných a 32 768 výstupných tokenov. Podporuje generovanie obrázkov, ukotvenie vo vyhľadávaní, uvažovanie a dávkové spracovanie, zatiaľ čo generovanie zvuku, ukladanie do vyrovnávacej pamäte, štruktúrované výstupy, vyhľadávanie v súboroch, Live API a kontext URL sú nepodporované. Obrazový pracovný postup neprijíma zvukový vstup. Video alebo PDF môžu v tomto profile API poskytnúť podklady pre úlohu s nehybným obrázkom; výstupom zostáva obrázok a text. Generované obrázky obsahujú SynthID a požadovaný počet obrázkov sa nie vždy dodrží presne.
Pri praktickej infografike poskytnite schválené označenia, zamýšľané publikum, poradie čítania, referenčný materiál a cieľový pomer strán. Požiadajte o jedno jasné vizuálne vysvetlenie a v ďalšom ťahu opravte znenie alebo rozostupy pri zachovaní vytvorenej kompozície. Pri produktovej makete určte geometriu, povrch, svetlo a vizuálne detaily definujúce produkt. Užitočným výsledkom je obrázok so súvisiacim textom, ktorý možno skontrolovať, vybrať a dolaďovať v riadenej sekvencii.
POST /v1/messagestextjson, sse| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity google/gemini-3.1-flash-image | Predvolené— |
Polemessages | Typmessage[] | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polemessages[].role | Typstring | PožiadavkaPovinné | Hodnoty a limity user, assistant | Predvolené— |
Polemessages[].content | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polemax_tokens | Typinteger | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Text · Text UTF-8
reťazec messages[].content
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, messages, max_tokens |
Parameteroptional_controls | Špecifikáciastream |
Parametermaterial_types | Špecifikáciatext |
Parametertext_file_material | ŠpecifikáciaPrečítajte skutočný dokument UTF-8 a vložte jeho text do uvedeného vstupného reťazca alebo reťazca obsahu správy. |
Životný cyklus: synchronous_or_streamed
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Počet tokenov kontextu väčší než | Tokeny kontextu, najviac (vrátane hranice) | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Počet tokenov kontextu väčší než— | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.001 / 1K tokenov Výstup · Výstupné tokeny $0.006 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov Výstup · Tokeny výstupného obrázka $0.12 / 1K obrazových tokenov |
| KonfiguráciaPásmo dĺžky požiadavky 1 | Sadzobník— | Počet tokenov kontextu väčší než0 | Tokeny kontextu, najviac (vrátane hranice)Bez hornej hranice | Poplatok Vstup · Vstupné tokeny $0.001 / 1K tokenov Výstup · Výstupné tokeny $0.006 / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
{\n "model": "google/gemini-3.1-flash-image",\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-3.1-flash-image', '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-3.1-flash-image', '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 alebo SSE
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachovajte všetky bloky obsahu, podpisy uvažovania a skutočné ID volaní nástrojov. Zostavte všetky čiastkové zmeny blokov SSE; prvý textový blok nie je celý výstup.
Zachovajte ID požiadaviek/odpovedí aj hlavičky. Všeobecná URL na načítanie textovej úlohy nie je poskytnutá.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polemodel | Typstring |
Polecontent[] | Typtext|thinking|tool_use|other content block |
Polestop_reason | Typstring|null |
Poleusage | Typobject |
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné polia, reprezentácia materiálu alebo hodnota parametra | Ďalší krokPred novou požiadavkou na vytvorenie opravte uvedené polia. |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
Technický príklad v angličtine
Create a simple bicycle-care infographic\n\nCreate one portrait infographic teaching three bicycle checks before a short ride: tires, brakes and chain. Use three large illustrated steps in that order, a warm ivory background and dark green accents. Include only these headings: 'TIRES', 'BRAKES', 'CHAIN'. Leave generous space around each heading and keep the illustrations clearly separated.One portrait image with three ordered illustrated steps and the three exact, readable headings.Inspect the rendered image for heading spelling, order and clear separation of the three checks.