Nano Banana 2 – Google Gemini 3.1 Flash Image modelis, skirtas įtaisytajam vaizdų generavimui ir redagavimui pokalbio metu. Jo projektavime pabrėžiamas efektyvus vizualinis kūrimas ir pasikartojančios pataisos. Dokumentuotas API profilis priima tekstą, vaizdus, vaizdo įrašus ir PDF bei grąžina vaizdą ir tekstą. Tai atskira pavadinta versija nuo Gemini Nano Banana 2.1, o ne kiekvieno vėlesnio Nano Banana atnaujinimo etiketė.
Išvesties dydžiai yra 0.5K, 1K, 2K ir 4K; numatytasis – 1K. Mažesnė 0.5K parinktis būdinga šiam profiliui ir gali tikti pradinei kompozicijai; didesni lygiai suteikia daugiau pikselių pasirinktos formos išvesčiai. Dokumentuoti kraštinių santykiai apima kvadratinius, portretinius ir gulsčius formatus: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ir 21:9, taip pat papildomus 1:4, 4:1, 1:8 ir 8:1 formatus. Pavyzdžiui, kvadratinė išvestis svyruoja nuo 512 × 512 esant 0.5K iki 4096 × 4096 esant 4K. Prieš tobulindami smulkias detales pasirinkite numatomai vietai tinkamą formą.
Tarp šios versijos patobulinimų Google nurodo geresnį kraštinių santykio laikymąsi, vizualinį nuoseklumą ir daugiakalbio teksto atvaizdavimą. Plakatui, meniu ar infografikui naudokite tikslias formuluotes ir apibrėžkite, kuri žyma priklauso kuriam objektui. Modelio kortelėje nurodomi likę smulkaus teksto ar ilgos ištraukos įskaitomumo apribojimai, ypač esant 1K. Prierašus laikykite glaustus ir aiškiai nurodykite santykinį jų dydį; tankaus pagrindinio teksto atveju vaizdą laikykite vizualinio maketo pavyzdžiu ir atidžiai patikrinkite tikruosius užrašus.
Vienoje darbo eigoje galima sujungti iki 14 pavyzdinių vaizdų. Vaizdų vadove aprašoma iki dešimties objektų atitiktis ir iki keturių personažų panašumo išlaikymas. Pažymėkite pavyzdžius ir nurodykite, ką kiekvienas suteikia. Produkto scenai vienas vaizdas gali nustatyti objektą, kitas – aplinką, trečias – apšvietimą. Personažų sekai ankstesnes išvestis perkelkite į kitą užklausą ir nurodykite savybes, kurios turi išlikti keičiantis žiūrėjimo taškui ar pozai.
Pagrindimas Web Search ir Image Search paieškomis gali papildyti generavimą aktualia informacija ir rastais vizualiniais pavyzdžiais. Image Search suteikia vizualinį kontekstą, o ne vien rašytinį paieškos rezultato aprašymą. Gamintojas paieškos funkciją palaiko su dokumentuotais samprotavimo nustatymais. Jo vaizdų paieškos darbo eigoje tikrų žmonių nuotraukos nenaudojamos kaip paieškoje gauti pavyzdžiai, o su pagrįstais rezultatais grąžinami šaltinių nurodymo metaduomenys; išsaugokite juos naudodami rezultatą programoje.
Dokumentuoti Gemini 3.1 Flash Image samprotavimo valdikliai yra minimal ir high; numatytasis – minimal. Tai skiriasi nuo Nano Banana 2.1 trijų lygių profilio su numatytuoju medium. Samprotavimas padeda tvarkyti sudėtingesnę kompoziciją ir instrukcijas. Modelis paremtas Gemini 3 Flash, tačiau šis ryšys nepaverčia jo bendrosios paskirties kodo vykdymo ar funkcijų iškvietimo modeliu: šios galimybės vaizdų versijos lentelėje pažymėtos kaip nepalaikomos.
Redagavimas pokalbio metu leidžia keisti pateiktą vaizdą ar tobulinti ankstesnį generavimą. Konkreti užduotis gali būti tokia: „Išsaugok butelio formą, etiketės tekstą ir kameros kampą. Pakeisk foną šviesiu akmens paviršiumi ir pridėk švelnesnių šešėlių.“ Išsaugomus elementus aprašykite taip pat kruopščiai kaip keičiamus. Modelio kortelėje pažymima, kad personažų nuoseklumas, kairės ir dešinės nustatymas bei pakeitimai pagal eskizą gali likti netobuli, todėl prieš tęsdami vizualinę seką palyginkite būtent šias detales.
API modelio lentelėje nurodyta 131,072 įvesties žetonų ir 32,768 išvesties žetonų. Palaikomi vaizdų generavimas, pagrindimas paieška, samprotavimas ir paketinis apdorojimas, o garso generavimas, podėlis, struktūrizuota išvestis, failų paieška, Live API ir URL kontekstas nepalaikomi. Vaizdų darbo eiga nepriima garso įvesties. Vaizdo įrašas ar PDF šiame API profilyje gali suteikti informacijos nejudančio vaizdo užduočiai; išvestis lieka vaizdas ir tekstas. Sugeneruoti vaizdai turi SynthID, o prašomo vaizdų skaičiaus ne visada laikomasi tiksliai.
Praktiniam infografikui pateikite patvirtintas žymas, numatomą auditoriją, skaitymo tvarką, pavyzdinę medžiagą ir tikslinį kraštinių santykį. Paprašykite vieno aiškaus vizualinio paaiškinimo, tada kitu ėjimu pataisykite formuluotes ar tarpus, išsaugodami nustatytą kompoziciją. Produkto maketui apibrėžkite geometriją, paviršių, šviesą ir produktą apibūdinančias vizualines detales. Naudingas rezultatas – vaizdas su susijusiu tekstu, kurį galima patikrinti, pasirinkti ir tobulinti kontroliuojama seka.
", "aboutText": "Nano Banana 2 – Google Gemini 3.1 Flash Image modelis, skirtas įtaisytajam vaizdų generavimui ir redagavimui pokalbio metu. Jo projektavime pabrėžiamas efektyvus vizualinis kūrimas ir pasikartojančios pataisos. Dokumentuotas API profilis priima tekstą, vaizdus, vaizdo įrašus ir PDF bei grąžina vaizdą ir tekstą. Tai atskira pavadinta versija nuo Gemini Nano Banana 2.1, o ne kiekvieno vėlesnio Nano Banana atnaujinimo etiketė.\n\nIšvesties dydžiai yra 0.5K, 1K, 2K ir 4K; numatytasis – 1K. Mažesnė 0.5K parinktis būdinga šiam profiliui ir gali tikti pradinei kompozicijai; didesni lygiai suteikia daugiau pikselių pasirinktos formos išvesčiai. Dokumentuoti kraštinių santykiai apima kvadratinius, portretinius ir gulsčius formatus: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ir 21:9, taip pat papildomus 1:4, 4:1, 1:8 ir 8:1 formatus. Pavyzdžiui, kvadratinė išvestis svyruoja nuo 512 × 512 esant 0.5K iki 4096 × 4096 esant 4K. Prieš tobulindami smulkias detales pasirinkite numatomai vietai tinkamą formą.\n\nTarp šios versijos patobulinimų Google nurodo geresnį kraštinių santykio laikymąsi, vizualinį nuoseklumą ir daugiakalbio teksto atvaizdavimą. Plakatui, meniu ar infografikui naudokite tikslias formuluotes ir apibrėžkite, kuri žyma priklauso kuriam objektui. Modelio kortelėje nurodomi likę smulkaus teksto ar ilgos ištraukos įskaitomumo apribojimai, ypač esant 1K. Prierašus laikykite glaustus ir aiškiai nurodykite santykinį jų dydį; tankaus pagrindinio teksto atveju vaizdą laikykite vizualinio maketo pavyzdžiu ir atidžiai patikrinkite tikruosius užrašus.\n\nVienoje darbo eigoje galima sujungti iki 14 pavyzdinių vaizdų. Vaizdų vadove aprašoma iki dešimties objektų atitiktis ir iki keturių personažų panašumo išlaikymas. Pažymėkite pavyzdžius ir nurodykite, ką kiekvienas suteikia. Produkto scenai vienas vaizdas gali nustatyti objektą, kitas – aplinką, trečias – apšvietimą. Personažų sekai ankstesnes išvestis perkelkite į kitą užklausą ir nurodykite savybes, kurios turi išlikti keičiantis žiūrėjimo taškui ar pozai.\n\nPagrindimas Web Search ir Image Search paieškomis gali papildyti generavimą aktualia informacija ir rastais vizualiniais pavyzdžiais. Image Search suteikia vizualinį kontekstą, o ne vien rašytinį paieškos rezultato aprašymą. Gamintojas paieškos funkciją palaiko su dokumentuotais samprotavimo nustatymais. Jo vaizdų paieškos darbo eigoje tikrų žmonių nuotraukos nenaudojamos kaip paieškoje gauti pavyzdžiai, o su pagrįstais rezultatais grąžinami šaltinių nurodymo metaduomenys; išsaugokite juos naudodami rezultatą programoje.\n\nDokumentuoti Gemini 3.1 Flash Image samprotavimo valdikliai yra minimal ir high; numatytasis – minimal. Tai skiriasi nuo Nano Banana 2.1 trijų lygių profilio su numatytuoju medium. Samprotavimas padeda tvarkyti sudėtingesnę kompoziciją ir instrukcijas. Modelis paremtas Gemini 3 Flash, tačiau šis ryšys nepaverčia jo bendrosios paskirties kodo vykdymo ar funkcijų iškvietimo modeliu: šios galimybės vaizdų versijos lentelėje pažymėtos kaip nepalaikomos.\n\nRedagavimas pokalbio metu leidžia keisti pateiktą vaizdą ar tobulinti ankstesnį generavimą. Konkreti užduotis gali būti tokia: „Išsaugok butelio formą, etiketės tekstą ir kameros kampą. Pakeisk foną šviesiu akmens paviršiumi ir pridėk švelnesnių šešėlių.“ Išsaugomus elementus aprašykite taip pat kruopščiai kaip keičiamus. Modelio kortelėje pažymima, kad personažų nuoseklumas, kairės ir dešinės nustatymas bei pakeitimai pagal eskizą gali likti netobuli, todėl prieš tęsdami vizualinę seką palyginkite būtent šias detales.\n\nAPI modelio lentelėje nurodyta 131,072 įvesties žetonų ir 32,768 išvesties žetonų. Palaikomi vaizdų generavimas, pagrindimas paieška, samprotavimas ir paketinis apdorojimas, o garso generavimas, podėlis, struktūrizuota išvestis, failų paieška, Live API ir URL kontekstas nepalaikomi. Vaizdų darbo eiga nepriima garso įvesties. Vaizdo įrašas ar PDF šiame API profilyje gali suteikti informacijos nejudančio vaizdo užduočiai; išvestis lieka vaizdas ir tekstas. Sugeneruoti vaizdai turi SynthID, o prašomo vaizdų skaičiaus ne visada laikomasi tiksliai.\n\nPraktiniam infografikui pateikite patvirtintas žymas, numatomą auditoriją, skaitymo tvarką, pavyzdinę medžiagą ir tikslinį kraštinių santykį. Paprašykite vieno aiškaus vizualinio paaiškinimo, tada kitu ėjimu pataisykite formuluotes ar tarpus, išsaugodami nustatytą kompoziciją. Produkto maketui apibrėžkite geometriją, paviršių, šviesą ir produktą apibūdinančias vizualines detales. Naudingas rezultatas – vaizdas su susijusiu tekstu, kurį galima patikrinti, pasirinkti ir tobulinti kontroliuojama seka.", "editorialOverlay": { "copy_fields": { "practical_html": "Techninis pavyzdys anglų kalba
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) generuoja ir redaguoja vaizdus pokalbio metu. Jis palaiko tekstinius ir vizualinius šaltinius, 0.5K–4K išvestį, kompoziciją pagal pavyzdinius vaizdus ir atsakymų pagrindimą paieška produktų scenoms, infografikams bei iteraciniam vizualiniam darbui.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Nano Banana 2 – Google Gemini 3.1 Flash Image modelis, skirtas įtaisytajam vaizdų generavimui ir redagavimui pokalbio metu. Jo projektavime pabrėžiamas efektyvus vizualinis kūrimas ir pasikartojančios pataisos. Dokumentuotas API profilis priima tekstą, vaizdus, vaizdo įrašus ir PDF bei grąžina vaizdą ir tekstą. Tai atskira pavadinta versija nuo Gemini Nano Banana 2.1, o ne kiekvieno vėlesnio Nano Banana atnaujinimo etiketė.
Išvesties dydžiai yra 0.5K, 1K, 2K ir 4K; numatytasis – 1K. Mažesnė 0.5K parinktis būdinga šiam profiliui ir gali tikti pradinei kompozicijai; didesni lygiai suteikia daugiau pikselių pasirinktos formos išvesčiai. Dokumentuoti kraštinių santykiai apima kvadratinius, portretinius ir gulsčius formatus: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ir 21:9, taip pat papildomus 1:4, 4:1, 1:8 ir 8:1 formatus. Pavyzdžiui, kvadratinė išvestis svyruoja nuo 512 × 512 esant 0.5K iki 4096 × 4096 esant 4K. Prieš tobulindami smulkias detales pasirinkite numatomai vietai tinkamą formą.
Tarp šios versijos patobulinimų Google nurodo geresnį kraštinių santykio laikymąsi, vizualinį nuoseklumą ir daugiakalbio teksto atvaizdavimą. Plakatui, meniu ar infografikui naudokite tikslias formuluotes ir apibrėžkite, kuri žyma priklauso kuriam objektui. Modelio kortelėje nurodomi likę smulkaus teksto ar ilgos ištraukos įskaitomumo apribojimai, ypač esant 1K. Prierašus laikykite glaustus ir aiškiai nurodykite santykinį jų dydį; tankaus pagrindinio teksto atveju vaizdą laikykite vizualinio maketo pavyzdžiu ir atidžiai patikrinkite tikruosius užrašus.
Vienoje darbo eigoje galima sujungti iki 14 pavyzdinių vaizdų. Vaizdų vadove aprašoma iki dešimties objektų atitiktis ir iki keturių personažų panašumo išlaikymas. Pažymėkite pavyzdžius ir nurodykite, ką kiekvienas suteikia. Produkto scenai vienas vaizdas gali nustatyti objektą, kitas – aplinką, trečias – apšvietimą. Personažų sekai ankstesnes išvestis perkelkite į kitą užklausą ir nurodykite savybes, kurios turi išlikti keičiantis žiūrėjimo taškui ar pozai.
Pagrindimas Web Search ir Image Search paieškomis gali papildyti generavimą aktualia informacija ir rastais vizualiniais pavyzdžiais. Image Search suteikia vizualinį kontekstą, o ne vien rašytinį paieškos rezultato aprašymą. Gamintojas paieškos funkciją palaiko su dokumentuotais samprotavimo nustatymais. Jo vaizdų paieškos darbo eigoje tikrų žmonių nuotraukos nenaudojamos kaip paieškoje gauti pavyzdžiai, o su pagrįstais rezultatais grąžinami šaltinių nurodymo metaduomenys; išsaugokite juos naudodami rezultatą programoje.
Dokumentuoti Gemini 3.1 Flash Image samprotavimo valdikliai yra minimal ir high; numatytasis – minimal. Tai skiriasi nuo Nano Banana 2.1 trijų lygių profilio su numatytuoju medium. Samprotavimas padeda tvarkyti sudėtingesnę kompoziciją ir instrukcijas. Modelis paremtas Gemini 3 Flash, tačiau šis ryšys nepaverčia jo bendrosios paskirties kodo vykdymo ar funkcijų iškvietimo modeliu: šios galimybės vaizdų versijos lentelėje pažymėtos kaip nepalaikomos.
Redagavimas pokalbio metu leidžia keisti pateiktą vaizdą ar tobulinti ankstesnį generavimą. Konkreti užduotis gali būti tokia: „Išsaugok butelio formą, etiketės tekstą ir kameros kampą. Pakeisk foną šviesiu akmens paviršiumi ir pridėk švelnesnių šešėlių.“ Išsaugomus elementus aprašykite taip pat kruopščiai kaip keičiamus. Modelio kortelėje pažymima, kad personažų nuoseklumas, kairės ir dešinės nustatymas bei pakeitimai pagal eskizą gali likti netobuli, todėl prieš tęsdami vizualinę seką palyginkite būtent šias detales.
API modelio lentelėje nurodyta 131,072 įvesties žetonų ir 32,768 išvesties žetonų. Palaikomi vaizdų generavimas, pagrindimas paieška, samprotavimas ir paketinis apdorojimas, o garso generavimas, podėlis, struktūrizuota išvestis, failų paieška, Live API ir URL kontekstas nepalaikomi. Vaizdų darbo eiga nepriima garso įvesties. Vaizdo įrašas ar PDF šiame API profilyje gali suteikti informacijos nejudančio vaizdo užduočiai; išvestis lieka vaizdas ir tekstas. Sugeneruoti vaizdai turi SynthID, o prašomo vaizdų skaičiaus ne visada laikomasi tiksliai.
Praktiniam infografikui pateikite patvirtintas žymas, numatomą auditoriją, skaitymo tvarką, pavyzdinę medžiagą ir tikslinį kraštinių santykį. Paprašykite vieno aiškaus vizualinio paaiškinimo, tada kitu ėjimu pataisykite formuluotes ar tarpus, išsaugodami nustatytą kompoziciją. Produkto maketui apibrėžkite geometriją, paviršių, šviesą ir produktą apibūdinančias vizualines detales. Naudingas rezultatas – vaizdas su susijusiu tekstu, kurį galima patikrinti, pasirinkti ir tobulinti kontroliuojama seka.
POST /v1/images/generationstextimage, text| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos gemini-3.1-flash-image | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 | Numatyta1 |
Laukasresponse_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos url, b64_json | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukassize | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasquality | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasbackground | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasoutput_format | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasoutput_compression | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasmoderation | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasinput_fidelity | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasstyle | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukaspartial_images | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Iš teksto į vaizdą · Privaloma: prompt
| Parametras | Specifikacija |
|---|---|
Parametrasmaterial_types | Specifikacijatext |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasoptional_controls | Specifikacijanull |
Parametrascontent_type | Specifikacijaapplication/json |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Metodų struktūros ir ID yra tikslūs; tiekėjo galimybės yra atskirtos nuo užklausos priėmimo.
POST /v1/images/generationsAiloot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
| Konfigūracija | Įkainių lentelė | Mokestis |
|---|---|---|
| KonfigūracijaUltra | Įkainių lentelėBazinis įkainis | Mokestis Įvestis · Įvesties tokenai $0.0010000 / 1K tokenų Išvestis · Išvesties tokenai $0.006000 / 1K tokenų Išvestis · vaizdo išvestis $0.12000 / 1K tokenų Išvestis · paieška žiniatinklyje $0.028 už paiešką internete |
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");\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}Išsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite kiekvieną duomenų elementą. Iškoduokite kiekvieną b64_json arba atsisiųskite turinį pagal kiekvieną grąžintą pasirašytą URL. Failo plėtinį pasirinkite pagal faktinį MIME tipą ir baitus.
Jei vaizdo generavimo ar redagavimo rezultatą reikia patikrinti, išsaugokite pradinį operation_id/X-Client-Request-ID ir grąžintą informaciją apie rezultatą. Atkurkite prieigą prie esamų jums priklausančių rezultatų per medijos biblioteką, naudodami faktines task_id arba asset_id reikšmes. Pakartotinai neteikite generavimo ar redagavimo užklausos ir nekurkite būsenos tikrinimo URL iš operation_id.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipasinteger |
Laukasdata[].url | Tipasstring |
Laukasdata[].b64_json | Tipasbase64 string |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Atsakymasserver_error | SąlygaGrąžintame atsakyme nurodoma, kad operaciją arba rezultatą reikia patikrinti | Kitas žingsnisIšsaugokite pradinį grąžintą operacijos ar užduoties ID, užklausos antraštes ir atsakymą; toliau tikrinkite tos pačios pradinės operacijos duomenis palaikomais būdais. Kūrimo užklausos pakartotinai neteikite. |
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) generuoja ir redaguoja vaizdus pokalbio metu. Jis palaiko tekstinius ir vizualinius šaltinius, 0.5K–4K išvestį, kompoziciją pagal pavyzdinius vaizdus ir atsakymų pagrindimą paieška produktų scenoms, infografikams bei iteraciniam vizualiniam darbui.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Nano Banana 2 – Google Gemini 3.1 Flash Image modelis, skirtas įtaisytajam vaizdų generavimui ir redagavimui pokalbio metu. Jo projektavime pabrėžiamas efektyvus vizualinis kūrimas ir pasikartojančios pataisos. Dokumentuotas API profilis priima tekstą, vaizdus, vaizdo įrašus ir PDF bei grąžina vaizdą ir tekstą. Tai atskira pavadinta versija nuo Gemini Nano Banana 2.1, o ne kiekvieno vėlesnio Nano Banana atnaujinimo etiketė.
Išvesties dydžiai yra 0.5K, 1K, 2K ir 4K; numatytasis – 1K. Mažesnė 0.5K parinktis būdinga šiam profiliui ir gali tikti pradinei kompozicijai; didesni lygiai suteikia daugiau pikselių pasirinktos formos išvesčiai. Dokumentuoti kraštinių santykiai apima kvadratinius, portretinius ir gulsčius formatus: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ir 21:9, taip pat papildomus 1:4, 4:1, 1:8 ir 8:1 formatus. Pavyzdžiui, kvadratinė išvestis svyruoja nuo 512 × 512 esant 0.5K iki 4096 × 4096 esant 4K. Prieš tobulindami smulkias detales pasirinkite numatomai vietai tinkamą formą.
Tarp šios versijos patobulinimų Google nurodo geresnį kraštinių santykio laikymąsi, vizualinį nuoseklumą ir daugiakalbio teksto atvaizdavimą. Plakatui, meniu ar infografikui naudokite tikslias formuluotes ir apibrėžkite, kuri žyma priklauso kuriam objektui. Modelio kortelėje nurodomi likę smulkaus teksto ar ilgos ištraukos įskaitomumo apribojimai, ypač esant 1K. Prierašus laikykite glaustus ir aiškiai nurodykite santykinį jų dydį; tankaus pagrindinio teksto atveju vaizdą laikykite vizualinio maketo pavyzdžiu ir atidžiai patikrinkite tikruosius užrašus.
Vienoje darbo eigoje galima sujungti iki 14 pavyzdinių vaizdų. Vaizdų vadove aprašoma iki dešimties objektų atitiktis ir iki keturių personažų panašumo išlaikymas. Pažymėkite pavyzdžius ir nurodykite, ką kiekvienas suteikia. Produkto scenai vienas vaizdas gali nustatyti objektą, kitas – aplinką, trečias – apšvietimą. Personažų sekai ankstesnes išvestis perkelkite į kitą užklausą ir nurodykite savybes, kurios turi išlikti keičiantis žiūrėjimo taškui ar pozai.
Pagrindimas Web Search ir Image Search paieškomis gali papildyti generavimą aktualia informacija ir rastais vizualiniais pavyzdžiais. Image Search suteikia vizualinį kontekstą, o ne vien rašytinį paieškos rezultato aprašymą. Gamintojas paieškos funkciją palaiko su dokumentuotais samprotavimo nustatymais. Jo vaizdų paieškos darbo eigoje tikrų žmonių nuotraukos nenaudojamos kaip paieškoje gauti pavyzdžiai, o su pagrįstais rezultatais grąžinami šaltinių nurodymo metaduomenys; išsaugokite juos naudodami rezultatą programoje.
Dokumentuoti Gemini 3.1 Flash Image samprotavimo valdikliai yra minimal ir high; numatytasis – minimal. Tai skiriasi nuo Nano Banana 2.1 trijų lygių profilio su numatytuoju medium. Samprotavimas padeda tvarkyti sudėtingesnę kompoziciją ir instrukcijas. Modelis paremtas Gemini 3 Flash, tačiau šis ryšys nepaverčia jo bendrosios paskirties kodo vykdymo ar funkcijų iškvietimo modeliu: šios galimybės vaizdų versijos lentelėje pažymėtos kaip nepalaikomos.
Redagavimas pokalbio metu leidžia keisti pateiktą vaizdą ar tobulinti ankstesnį generavimą. Konkreti užduotis gali būti tokia: „Išsaugok butelio formą, etiketės tekstą ir kameros kampą. Pakeisk foną šviesiu akmens paviršiumi ir pridėk švelnesnių šešėlių.“ Išsaugomus elementus aprašykite taip pat kruopščiai kaip keičiamus. Modelio kortelėje pažymima, kad personažų nuoseklumas, kairės ir dešinės nustatymas bei pakeitimai pagal eskizą gali likti netobuli, todėl prieš tęsdami vizualinę seką palyginkite būtent šias detales.
API modelio lentelėje nurodyta 131,072 įvesties žetonų ir 32,768 išvesties žetonų. Palaikomi vaizdų generavimas, pagrindimas paieška, samprotavimas ir paketinis apdorojimas, o garso generavimas, podėlis, struktūrizuota išvestis, failų paieška, Live API ir URL kontekstas nepalaikomi. Vaizdų darbo eiga nepriima garso įvesties. Vaizdo įrašas ar PDF šiame API profilyje gali suteikti informacijos nejudančio vaizdo užduočiai; išvestis lieka vaizdas ir tekstas. Sugeneruoti vaizdai turi SynthID, o prašomo vaizdų skaičiaus ne visada laikomasi tiksliai.
Praktiniam infografikui pateikite patvirtintas žymas, numatomą auditoriją, skaitymo tvarką, pavyzdinę medžiagą ir tikslinį kraštinių santykį. Paprašykite vieno aiškaus vizualinio paaiškinimo, tada kitu ėjimu pataisykite formuluotes ar tarpus, išsaugodami nustatytą kompoziciją. Produkto maketui apibrėžkite geometriją, paviršių, šviesą ir produktą apibūdinančias vizualines detales. Naudingas rezultatas – vaizdas su susijusiu tekstu, kurį galima patikrinti, pasirinkti ir tobulinti kontroliuojama seka.
POST /v1/chat/completionstexttext| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos google/gemini-3.1-flash-image | Numatyta— |
Laukasmessages | Tipasmessage[] | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 | Numatyta— |
Laukasmessages[].role | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Pavyzdžiai: system, user, assistant, tool, function Sąlygos: Šie vaidmenys aiškiai išreikšti šaltinio kodo suderinamumo tipuose; tikslus vaidmenų rinkinys priklauso nuo konkretaus modelio. Priklauso nuo modelio | Numatyta— |
Laukasmessages[].content | Tipasstring|content_part[]|null | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasmessages[].tool_calls | Tipastool_call[] | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasmessages[].tool_call_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Taikoma, kai: role=tool; naudokite tikrąjį grąžintą ID | Numatyta— |
Laukasmessages[].name | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasmessages[].reasoning_content | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Taikoma, kai: Grąžinkite tikrąjį gautą samprotavimą ten, kur šis modelis jį naudoja | Numatyta— |
Laukasmessages[].reasoning_details | Tipasobject|array | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasmax_tokens | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Priklauso nuo modelio | Numatyta— |
Laukasmax_completion_tokens | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Priklauso nuo modelio | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukasstream_options.include_usage | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukastemperature | Tipasnumber | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukastop_p | Tipasnumber | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasstop | Tipasstring|string[] | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukastools | Tipasfunction_tool[] | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukastools[].type | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos function Priklauso nuo modelio | Numatyta— |
Laukastools[].function.name | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Taikoma, kai: pateiktas funkcijos tipo įrankis | Numatyta— |
Laukastools[].function.description | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastools[].function.parameters | TipasJSON_schema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastool_choice | Tipasstring|object | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasparallel_tool_calls | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasresponse_format | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasreasoning_effort | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasreasoning | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasservice_tier | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasinstructions | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Suderinamumo laukas | Numatyta— |
Laukasfunctions | Tipasfunction[] | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasfunction_call | Tipasstring|object | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasprompt_cache_options | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos Priklauso nuo modelio | Numatyta— |
Laukasmodalities | Tipasstring[] | ReikalavimasNeprivaloma | Reikšmės ir ribos text | Numatyta— |
Laukasprovider | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: provider.options šiame Ultra teksto maršrute atmetamas | Numatyta— |
Laukascache_control.ttl | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: 1h atmetamas tikrosiose užklausų podėlio vietose | Numatyta— |
Tekstas · UTF8 tekstas
messages[].content
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, messages |
Parametrasmaterial_types | Specifikacijatext |
Parametrasmessages | Specifikacijapranešimų masyvas su role/content struktūra |
Parametrasfile_material | Specifikacijatikrasis UTF-8 dokumentas įterptas kaip pažodinis tekstas; failo ID nenumanomas |
Parametrasoptional_controls | Specifikacijastream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametrascontrol_scope | Specifikacijapriklauso nuo modelio; naudotojo funkcijų įrankiai skiriasi nuo priglobtų įrankių |
Parametrasoutput_modalities | Specifikacijatext |
Parametrashosted_operations | Specifikacijafalse |
Parametrasmultimodal_input_binding | Specifikacijanull |
Gyvavimo ciklas: synchronous_or_streamed
Siųskite tikslų modelio ID kartu su messages.
Konteksto ilgis nėra išvesties limitas.
Teksto failas gali pateikti pažodinį tekstą; vaizdų / garso / failų objektų įvestims reikia tikslaus susiejimo.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Konteksto tokenų daugiau nei | Konteksto tokenų iki imtinai | Mokestis |
|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Konteksto tokenų daugiau nei— | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0.001 / 1K tokenų Išvestis · Išvesties tokenai $0.006 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų Išvestis · Vaizdo išvesties žetonai $0.12 / 1K vaizdo tokenų |
| KonfigūracijaUžklausos ilgio pakopa 1 | Įkainių lentelė— | Konteksto tokenų daugiau nei0 | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0.001 / 1K tokenų Išvestis · Išvesties tokenai $0.006 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaGoogle: Nano Banana 2 (Gemini 3.1 Flash Image) · Numatytoji konfigūracija | Apmokestinimo sąlygosNumatytoji konfigūracija | Mokestis Įvestis · Įvesties tokenai 0,001 USD / 1K tokenų Išvestis · Išvesties tokenai 0,006 USD / 1K tokenų Išvestis · Išvesties vaizdas 0,12 USD / 1K tokenų Išvestis · Paieška žiniatinklyje 0,028 USD už paiešką |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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 arba SSE
Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.
Išsaugokite kiekvieną variantą ir jo turinį / įrankių iškvietimus / samprotavimą. SSE prieaugius surinkite pagal varianto / įrankio indeksą; išsaugokite galutinę užbaigimo priežastį ir naudojimo duomenis.
Išsaugokite užklausų / atsakymų ID ir antraštes. Bendras teksto užduoties gavimo URL nepateikiamas.
| Laukas | Tipas |
|---|---|
Laukaschoices[].index | Tipasinteger |
Laukaschoices[].message.content | Tipasstring|null |
Laukaschoices[].message.tool_calls | Tipastool_call[] |
Laukaschoices[].message.reasoning_content | Tipasstring |
Laukaschoices[].message.reasoning_details | Tipasobject|array |
Laukaschoices[].finish_reason | Tipasstring|null |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
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) generuoja ir redaguoja vaizdus pokalbio metu. Jis palaiko tekstinius ir vizualinius šaltinius, 0.5K–4K išvestį, kompoziciją pagal pavyzdinius vaizdus ir atsakymų pagrindimą paieška produktų scenoms, infografikams bei iteraciniam vizualiniam darbui.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Nano Banana 2 – Google Gemini 3.1 Flash Image modelis, skirtas įtaisytajam vaizdų generavimui ir redagavimui pokalbio metu. Jo projektavime pabrėžiamas efektyvus vizualinis kūrimas ir pasikartojančios pataisos. Dokumentuotas API profilis priima tekstą, vaizdus, vaizdo įrašus ir PDF bei grąžina vaizdą ir tekstą. Tai atskira pavadinta versija nuo Gemini Nano Banana 2.1, o ne kiekvieno vėlesnio Nano Banana atnaujinimo etiketė.
Išvesties dydžiai yra 0.5K, 1K, 2K ir 4K; numatytasis – 1K. Mažesnė 0.5K parinktis būdinga šiam profiliui ir gali tikti pradinei kompozicijai; didesni lygiai suteikia daugiau pikselių pasirinktos formos išvesčiai. Dokumentuoti kraštinių santykiai apima kvadratinius, portretinius ir gulsčius formatus: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ir 21:9, taip pat papildomus 1:4, 4:1, 1:8 ir 8:1 formatus. Pavyzdžiui, kvadratinė išvestis svyruoja nuo 512 × 512 esant 0.5K iki 4096 × 4096 esant 4K. Prieš tobulindami smulkias detales pasirinkite numatomai vietai tinkamą formą.
Tarp šios versijos patobulinimų Google nurodo geresnį kraštinių santykio laikymąsi, vizualinį nuoseklumą ir daugiakalbio teksto atvaizdavimą. Plakatui, meniu ar infografikui naudokite tikslias formuluotes ir apibrėžkite, kuri žyma priklauso kuriam objektui. Modelio kortelėje nurodomi likę smulkaus teksto ar ilgos ištraukos įskaitomumo apribojimai, ypač esant 1K. Prierašus laikykite glaustus ir aiškiai nurodykite santykinį jų dydį; tankaus pagrindinio teksto atveju vaizdą laikykite vizualinio maketo pavyzdžiu ir atidžiai patikrinkite tikruosius užrašus.
Vienoje darbo eigoje galima sujungti iki 14 pavyzdinių vaizdų. Vaizdų vadove aprašoma iki dešimties objektų atitiktis ir iki keturių personažų panašumo išlaikymas. Pažymėkite pavyzdžius ir nurodykite, ką kiekvienas suteikia. Produkto scenai vienas vaizdas gali nustatyti objektą, kitas – aplinką, trečias – apšvietimą. Personažų sekai ankstesnes išvestis perkelkite į kitą užklausą ir nurodykite savybes, kurios turi išlikti keičiantis žiūrėjimo taškui ar pozai.
Pagrindimas Web Search ir Image Search paieškomis gali papildyti generavimą aktualia informacija ir rastais vizualiniais pavyzdžiais. Image Search suteikia vizualinį kontekstą, o ne vien rašytinį paieškos rezultato aprašymą. Gamintojas paieškos funkciją palaiko su dokumentuotais samprotavimo nustatymais. Jo vaizdų paieškos darbo eigoje tikrų žmonių nuotraukos nenaudojamos kaip paieškoje gauti pavyzdžiai, o su pagrįstais rezultatais grąžinami šaltinių nurodymo metaduomenys; išsaugokite juos naudodami rezultatą programoje.
Dokumentuoti Gemini 3.1 Flash Image samprotavimo valdikliai yra minimal ir high; numatytasis – minimal. Tai skiriasi nuo Nano Banana 2.1 trijų lygių profilio su numatytuoju medium. Samprotavimas padeda tvarkyti sudėtingesnę kompoziciją ir instrukcijas. Modelis paremtas Gemini 3 Flash, tačiau šis ryšys nepaverčia jo bendrosios paskirties kodo vykdymo ar funkcijų iškvietimo modeliu: šios galimybės vaizdų versijos lentelėje pažymėtos kaip nepalaikomos.
Redagavimas pokalbio metu leidžia keisti pateiktą vaizdą ar tobulinti ankstesnį generavimą. Konkreti užduotis gali būti tokia: „Išsaugok butelio formą, etiketės tekstą ir kameros kampą. Pakeisk foną šviesiu akmens paviršiumi ir pridėk švelnesnių šešėlių.“ Išsaugomus elementus aprašykite taip pat kruopščiai kaip keičiamus. Modelio kortelėje pažymima, kad personažų nuoseklumas, kairės ir dešinės nustatymas bei pakeitimai pagal eskizą gali likti netobuli, todėl prieš tęsdami vizualinę seką palyginkite būtent šias detales.
API modelio lentelėje nurodyta 131,072 įvesties žetonų ir 32,768 išvesties žetonų. Palaikomi vaizdų generavimas, pagrindimas paieška, samprotavimas ir paketinis apdorojimas, o garso generavimas, podėlis, struktūrizuota išvestis, failų paieška, Live API ir URL kontekstas nepalaikomi. Vaizdų darbo eiga nepriima garso įvesties. Vaizdo įrašas ar PDF šiame API profilyje gali suteikti informacijos nejudančio vaizdo užduočiai; išvestis lieka vaizdas ir tekstas. Sugeneruoti vaizdai turi SynthID, o prašomo vaizdų skaičiaus ne visada laikomasi tiksliai.
Praktiniam infografikui pateikite patvirtintas žymas, numatomą auditoriją, skaitymo tvarką, pavyzdinę medžiagą ir tikslinį kraštinių santykį. Paprašykite vieno aiškaus vizualinio paaiškinimo, tada kitu ėjimu pataisykite formuluotes ar tarpus, išsaugodami nustatytą kompoziciją. Produkto maketui apibrėžkite geometriją, paviršių, šviesą ir produktą apibūdinančias vizualines detales. Naudingas rezultatas – vaizdas su susijusiu tekstu, kurį galima patikrinti, pasirinkti ir tobulinti kontroliuojama seka.
POST /v1/images/generationstext, imageimage| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos google/gemini-3.1-flash-image | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos Mažiausias ilgis: 1 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 512, 1K, 2K, 4K | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 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 | Numatyta— |
Laukasn | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 Didžiausia reikšmė: 1 | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 0 Didžiausias elementų skaičius: 14 | Numatyta— |
Laukasprovider | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt |
Parametrasmaterial_types | Specifikacijatext, image |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktiškai grąžinta task_id reikšmė arba medijos bibliotekos įrašas
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.49152 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
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\nAtsisiųskite kiekvieną grąžintą vaizdą arba išsaugokite jo Base64 turinį
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.\nIšsaugokite kiekvieną baigtą vaizdą; gaukite turinį iš kiekvieno grąžinto URL arba dekoduokite jo Base64 turinį.
Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.
Išsaugokite grąžintą X-Client-Request-ID duomenims sutikrinti. Tikrinkite tik faktiškai grąžintas task_id/asset_id reikšmes arba jums priklausančią medijos biblioteką; niekada nekurkite užduoties URL iš operacijos ID ir niekada pakartotinai neteikite kūrimo užklausos.
| Laukas | Tipas |
|---|---|
Laukascreated | Tipas |
Laukasdata[].url | Tipas |
Laukasdata[].b64_json | Tipas |
Laukasusage | Tipas |
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) generuoja ir redaguoja vaizdus pokalbio metu. Jis palaiko tekstinius ir vizualinius šaltinius, 0.5K–4K išvestį, kompoziciją pagal pavyzdinius vaizdus ir atsakymų pagrindimą paieška produktų scenoms, infografikams bei iteraciniam vizualiniam darbui.
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Nano Banana 2 – Google Gemini 3.1 Flash Image modelis, skirtas įtaisytajam vaizdų generavimui ir redagavimui pokalbio metu. Jo projektavime pabrėžiamas efektyvus vizualinis kūrimas ir pasikartojančios pataisos. Dokumentuotas API profilis priima tekstą, vaizdus, vaizdo įrašus ir PDF bei grąžina vaizdą ir tekstą. Tai atskira pavadinta versija nuo Gemini Nano Banana 2.1, o ne kiekvieno vėlesnio Nano Banana atnaujinimo etiketė.
Išvesties dydžiai yra 0.5K, 1K, 2K ir 4K; numatytasis – 1K. Mažesnė 0.5K parinktis būdinga šiam profiliui ir gali tikti pradinei kompozicijai; didesni lygiai suteikia daugiau pikselių pasirinktos formos išvesčiai. Dokumentuoti kraštinių santykiai apima kvadratinius, portretinius ir gulsčius formatus: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 ir 21:9, taip pat papildomus 1:4, 4:1, 1:8 ir 8:1 formatus. Pavyzdžiui, kvadratinė išvestis svyruoja nuo 512 × 512 esant 0.5K iki 4096 × 4096 esant 4K. Prieš tobulindami smulkias detales pasirinkite numatomai vietai tinkamą formą.
Tarp šios versijos patobulinimų Google nurodo geresnį kraštinių santykio laikymąsi, vizualinį nuoseklumą ir daugiakalbio teksto atvaizdavimą. Plakatui, meniu ar infografikui naudokite tikslias formuluotes ir apibrėžkite, kuri žyma priklauso kuriam objektui. Modelio kortelėje nurodomi likę smulkaus teksto ar ilgos ištraukos įskaitomumo apribojimai, ypač esant 1K. Prierašus laikykite glaustus ir aiškiai nurodykite santykinį jų dydį; tankaus pagrindinio teksto atveju vaizdą laikykite vizualinio maketo pavyzdžiu ir atidžiai patikrinkite tikruosius užrašus.
Vienoje darbo eigoje galima sujungti iki 14 pavyzdinių vaizdų. Vaizdų vadove aprašoma iki dešimties objektų atitiktis ir iki keturių personažų panašumo išlaikymas. Pažymėkite pavyzdžius ir nurodykite, ką kiekvienas suteikia. Produkto scenai vienas vaizdas gali nustatyti objektą, kitas – aplinką, trečias – apšvietimą. Personažų sekai ankstesnes išvestis perkelkite į kitą užklausą ir nurodykite savybes, kurios turi išlikti keičiantis žiūrėjimo taškui ar pozai.
Pagrindimas Web Search ir Image Search paieškomis gali papildyti generavimą aktualia informacija ir rastais vizualiniais pavyzdžiais. Image Search suteikia vizualinį kontekstą, o ne vien rašytinį paieškos rezultato aprašymą. Gamintojas paieškos funkciją palaiko su dokumentuotais samprotavimo nustatymais. Jo vaizdų paieškos darbo eigoje tikrų žmonių nuotraukos nenaudojamos kaip paieškoje gauti pavyzdžiai, o su pagrįstais rezultatais grąžinami šaltinių nurodymo metaduomenys; išsaugokite juos naudodami rezultatą programoje.
Dokumentuoti Gemini 3.1 Flash Image samprotavimo valdikliai yra minimal ir high; numatytasis – minimal. Tai skiriasi nuo Nano Banana 2.1 trijų lygių profilio su numatytuoju medium. Samprotavimas padeda tvarkyti sudėtingesnę kompoziciją ir instrukcijas. Modelis paremtas Gemini 3 Flash, tačiau šis ryšys nepaverčia jo bendrosios paskirties kodo vykdymo ar funkcijų iškvietimo modeliu: šios galimybės vaizdų versijos lentelėje pažymėtos kaip nepalaikomos.
Redagavimas pokalbio metu leidžia keisti pateiktą vaizdą ar tobulinti ankstesnį generavimą. Konkreti užduotis gali būti tokia: „Išsaugok butelio formą, etiketės tekstą ir kameros kampą. Pakeisk foną šviesiu akmens paviršiumi ir pridėk švelnesnių šešėlių.“ Išsaugomus elementus aprašykite taip pat kruopščiai kaip keičiamus. Modelio kortelėje pažymima, kad personažų nuoseklumas, kairės ir dešinės nustatymas bei pakeitimai pagal eskizą gali likti netobuli, todėl prieš tęsdami vizualinę seką palyginkite būtent šias detales.
API modelio lentelėje nurodyta 131,072 įvesties žetonų ir 32,768 išvesties žetonų. Palaikomi vaizdų generavimas, pagrindimas paieška, samprotavimas ir paketinis apdorojimas, o garso generavimas, podėlis, struktūrizuota išvestis, failų paieška, Live API ir URL kontekstas nepalaikomi. Vaizdų darbo eiga nepriima garso įvesties. Vaizdo įrašas ar PDF šiame API profilyje gali suteikti informacijos nejudančio vaizdo užduočiai; išvestis lieka vaizdas ir tekstas. Sugeneruoti vaizdai turi SynthID, o prašomo vaizdų skaičiaus ne visada laikomasi tiksliai.
Praktiniam infografikui pateikite patvirtintas žymas, numatomą auditoriją, skaitymo tvarką, pavyzdinę medžiagą ir tikslinį kraštinių santykį. Paprašykite vieno aiškaus vizualinio paaiškinimo, tada kitu ėjimu pataisykite formuluotes ar tarpus, išsaugodami nustatytą kompoziciją. Produkto maketui apibrėžkite geometriją, paviršių, šviesą ir produktą apibūdinančias vizualines detales. Naudingas rezultatas – vaizdas su susijusiu tekstu, kurį galima patikrinti, pasirinkti ir tobulinti kontroliuojama seka.
POST /v1/messagestextjson, sse| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos google/gemini-3.1-flash-image | Numatyta— |
Laukasmessages | Tipasmessage[] | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasmessages[].role | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos user, assistant | Numatyta— |
Laukasmessages[].content | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasmax_tokens | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasstream | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Tekstas · UTF-8 tekstas
messages[].content eilutė
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, messages, max_tokens |
Parametrasoptional_controls | Specifikacijastream |
Parametrasmaterial_types | Specifikacijatext |
Parametrastext_file_material | SpecifikacijaPerskaitykite tikrąjį UTF-8 dokumentą ir įterpkite jo tekstą į nurodytą input lauką arba pranešimo turinio eilutę. |
Gyvavimo ciklas: synchronous_or_streamed
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Konteksto tokenų daugiau nei | Konteksto tokenų iki imtinai | Mokestis |
|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Konteksto tokenų daugiau nei— | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0.001 / 1K tokenų Išvestis · Išvesties tokenai $0.006 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų Išvestis · Vaizdo išvesties žetonai $0.12 / 1K vaizdo tokenų |
| KonfigūracijaUžklausos ilgio pakopa 1 | Įkainių lentelė— | Konteksto tokenų daugiau nei0 | Konteksto tokenų iki imtinaiBe viršutinės ribos | Mokestis Įvestis · Įvesties tokenai $0.001 / 1K tokenų Išvestis · Išvesties tokenai $0.006 / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
{\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 arba SSE
Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.
Išsaugokite visus turinio blokus, mąstymo parašus ir tikruosius įrankių naudojimo ID. Surinkite visus SSE blokų prieaugius; pirmasis teksto blokas nėra visa išvestis.
Išsaugokite užklausų / atsakymų ID ir antraštes. Bendras teksto užduoties gavimo URL nepateikiamas.
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukasmodel | Tipasstring |
Laukascontent[] | Tipastext|thinking|tool_use|other content block |
Laukasstop_reason | Tipasstring|null |
Laukasusage | Tipasobject |
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkami privalomi laukai, medžiagos pateikimo forma arba parametro reikšmė | Kitas žingsnisPrieš naują kūrimo užklausą pataisykite nurodytus laukus. |
Ailoot gemini-3.1-flash-image
Ailoot Ultra google/gemini-3.1-flash-image
/v1/images
Techninis pavyzdys anglų kalba
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.