Nano Banana 2 je Googlov model Gemini 3.1 Flash Image za ustvarjanje slik in urejanje skozi pogovor. Ta vnos ohranja natančno identiteto Preview. Pisni opis lahko določi nov vizualni prikaz, vhodna slika pa motiv, videz ali kompozicijo, ki jo je treba spremeniti. Rezultat lahko vsebuje sliko in spremljevalno besedilo. Googlovo gradivo ob predstavitvi poudarja znanje o svetu, izris besedila in doslednost motivov ter možnost izpopolnjevanja prizora skozi povezane izmenjave.
Pri vizualnem ustvarjanju, utemeljenem z viri, lahko dokumentirani model pri ustvarjanju uporabi informacije iz spletnega in slikovnega iskanja. To podpira naloge, kot sta ilustracija po navdihu lokacije ali diagram na podlagi priloženih informacij. Določite izvorna dejstva, ki morajo biti predstavljena, in jih ločite od umetniških odločitev. Ustvarjanje ob pomoči iskanja ne pomeni, da je vsaka podrobnost na končni sliki preverjena trditev. Če mora biti izdelek, znamenitost ali diagram natančen, priložite merodajno referenco in izhod preverite glede nanjo.
Predstavitev opisuje izboljšan izris besedila v sliki in lokalizacijo. Pri plakatu, infografiki ali marketinški maketi podajte natančno ubeseditev, jezik in vlogo vsakega besedilnega elementa. Najprej dokončno določite besedilo, nato zahtevajte vizualni prikaz, ki ga vsebuje, kot priporoča vodnik za slike. Pojasnite vrstni red branja in relativne poudarke, da se naslov, pripis in oznaka diagrama ne zamenjajo. Pred uporabo slike v objavi preverite pravopis, ločila in povezavo med oznako ter prikazanim elementom.
Ustvarjalne nastavitve vključujejo razmerje stranic in ločljivost. Predstavitev poleg možnosti 1K, 2K in 4K dodaja izhod s 512 slikovnimi pikami ter razmerja stranic 4:1, 1:4, 8:1 in 1:8. Vodnik za razvijalce določa minimal kot privzeto raven razmišljanja in high kot možnost za zahtevnejše kompozicije. Pred kompozicijo izberite predvideno uporabo: pokončna zgodba, široka pasica in strnjen diagram potrebujejo različen prostor za motiv in morebitno besedilo. Te nastavitve opisujejo proizvajalčev postopek ustvarjanja za to linijo, ne samodejnega spreminjanja velikosti že dokončanega izdelka.
Za doslednost motivov označite vlogo vsake reference: videz izdelka, identiteta lika, ozadje ali vizualni slog. Navedite podrobnosti, ki jih je treba ohraniti, nato pa elemente, ki jih je treba spremeniti. Izvirna naloga lahko priloženo fotografijo izdelka umesti v nov prizor ter ohrani njegovo obliko, material in vidne oznake znamke. Pri ilustriranem zaporedju ohranite iste reference in določite, katere podrobnosti se med prizori spreminjajo. Več referenc ne nadomesti jasnega navodila, kaj prispeva vsaka slika.
Urejanje skozi pogovor je uporabno za konkretno spremembo. Zahtevajte prilagoditev enega predmeta, ozadja ali osvetlitve ob ohranitvi sprejete kompozicije. Proizvajalčev vodnik opisuje semantično maskiranje, pri katerem je urejano območje opredeljeno z besedami. Pri delu v več izmenjavah ohranite pogovor in zahtevane metapodatke konteksta sklepanja v izbranem vmesniku; vodnik Gemini 3 pojasnjuje, da podpisi razmišljanja pomagajo prenašati ta kontekst. Opis nespremenjenega območja je navodilo, ki ga je treba preveriti glede na izvirnik, ne jamstvo, da vsaka slikovna pika ostane enaka.
Preglednica za razvijalce Gemini 3 izrecno navaja gemini-3.1-flash-image-preview z vhodnim obsegom 128K in izhodnim obsegom 32K. Pri beleženju ustvarjanja ohranite natančno ime modela Preview. Razpoložljive nastavitve referenc, izhoda in ločljivosti hranite skupaj z izvornimi slikami in zahtevo, da je spremembo mogoče dosledno ponoviti. Pri spremembi ohranite iste izvorne reference in določite natančno vizualno spremembo ter obdržite sprejeto vlogo vsakega vhoda.
Vodnik za slike opozarja, da zahtevano število slik morda ne bo vedno upoštevano, in navaja označevanje ustvarjenih slik s SynthID. Preverite vse vrnjene slike in morebitno spremljevalno besedilo, namesto da bi domnevali, da je rezultat ena določena slika. Pri predvideni velikosti prikaza preverite identiteto motiva, število predmetov, besedilo v sliki, kompozicijo in zvestobo referencam. Pri zahtevnem prizoru navedite sestavne dele v logičnem vrstnem redu in želeni videz opišite s pozitivnimi navodili. Uporaben rezultat je pregledan vizualni izdelek, pri katerem so za naslednje urejanje ohranjene izvorne reference in natančna identiteta modela.
", "aboutText": "Nano Banana 2 je Googlov model Gemini 3.1 Flash Image za ustvarjanje slik in urejanje skozi pogovor. Ta vnos ohranja natančno identiteto Preview. Pisni opis lahko določi nov vizualni prikaz, vhodna slika pa motiv, videz ali kompozicijo, ki jo je treba spremeniti. Rezultat lahko vsebuje sliko in spremljevalno besedilo. Googlovo gradivo ob predstavitvi poudarja znanje o svetu, izris besedila in doslednost motivov ter možnost izpopolnjevanja prizora skozi povezane izmenjave.\n\nPri vizualnem ustvarjanju, utemeljenem z viri, lahko dokumentirani model pri ustvarjanju uporabi informacije iz spletnega in slikovnega iskanja. To podpira naloge, kot sta ilustracija po navdihu lokacije ali diagram na podlagi priloženih informacij. Določite izvorna dejstva, ki morajo biti predstavljena, in jih ločite od umetniških odločitev. Ustvarjanje ob pomoči iskanja ne pomeni, da je vsaka podrobnost na končni sliki preverjena trditev. Če mora biti izdelek, znamenitost ali diagram natančen, priložite merodajno referenco in izhod preverite glede nanjo.\n\nPredstavitev opisuje izboljšan izris besedila v sliki in lokalizacijo. Pri plakatu, infografiki ali marketinški maketi podajte natančno ubeseditev, jezik in vlogo vsakega besedilnega elementa. Najprej dokončno določite besedilo, nato zahtevajte vizualni prikaz, ki ga vsebuje, kot priporoča vodnik za slike. Pojasnite vrstni red branja in relativne poudarke, da se naslov, pripis in oznaka diagrama ne zamenjajo. Pred uporabo slike v objavi preverite pravopis, ločila in povezavo med oznako ter prikazanim elementom.\n\nUstvarjalne nastavitve vključujejo razmerje stranic in ločljivost. Predstavitev poleg možnosti 1K, 2K in 4K dodaja izhod s 512 slikovnimi pikami ter razmerja stranic 4:1, 1:4, 8:1 in 1:8. Vodnik za razvijalce določa minimal kot privzeto raven razmišljanja in high kot možnost za zahtevnejše kompozicije. Pred kompozicijo izberite predvideno uporabo: pokončna zgodba, široka pasica in strnjen diagram potrebujejo različen prostor za motiv in morebitno besedilo. Te nastavitve opisujejo proizvajalčev postopek ustvarjanja za to linijo, ne samodejnega spreminjanja velikosti že dokončanega izdelka.\n\nZa doslednost motivov označite vlogo vsake reference: videz izdelka, identiteta lika, ozadje ali vizualni slog. Navedite podrobnosti, ki jih je treba ohraniti, nato pa elemente, ki jih je treba spremeniti. Izvirna naloga lahko priloženo fotografijo izdelka umesti v nov prizor ter ohrani njegovo obliko, material in vidne oznake znamke. Pri ilustriranem zaporedju ohranite iste reference in določite, katere podrobnosti se med prizori spreminjajo. Več referenc ne nadomesti jasnega navodila, kaj prispeva vsaka slika.\n\nUrejanje skozi pogovor je uporabno za konkretno spremembo. Zahtevajte prilagoditev enega predmeta, ozadja ali osvetlitve ob ohranitvi sprejete kompozicije. Proizvajalčev vodnik opisuje semantično maskiranje, pri katerem je urejano območje opredeljeno z besedami. Pri delu v več izmenjavah ohranite pogovor in zahtevane metapodatke konteksta sklepanja v izbranem vmesniku; vodnik Gemini 3 pojasnjuje, da podpisi razmišljanja pomagajo prenašati ta kontekst. Opis nespremenjenega območja je navodilo, ki ga je treba preveriti glede na izvirnik, ne jamstvo, da vsaka slikovna pika ostane enaka.\n\nPreglednica za razvijalce Gemini 3 izrecno navaja gemini-3.1-flash-image-preview z vhodnim obsegom 128K in izhodnim obsegom 32K. Pri beleženju ustvarjanja ohranite natančno ime modela Preview. Razpoložljive nastavitve referenc, izhoda in ločljivosti hranite skupaj z izvornimi slikami in zahtevo, da je spremembo mogoče dosledno ponoviti. Pri spremembi ohranite iste izvorne reference in določite natančno vizualno spremembo ter obdržite sprejeto vlogo vsakega vhoda.\n\nVodnik za slike opozarja, da zahtevano število slik morda ne bo vedno upoštevano, in navaja označevanje ustvarjenih slik s SynthID. Preverite vse vrnjene slike in morebitno spremljevalno besedilo, namesto da bi domnevali, da je rezultat ena določena slika. Pri predvideni velikosti prikaza preverite identiteto motiva, število predmetov, besedilo v sliki, kompozicijo in zvestobo referencam. Pri zahtevnem prizoru navedite sestavne dele v logičnem vrstnem redu in želeni videz opišite s pozitivnimi navodili. Uporaben rezultat je pregledan vizualni izdelek, pri katerem so za naslednje urejanje ohranjene izvorne reference in natančna identiteta modela.", "editorialOverlay": { "copy_fields": { "practical_html": "Tehnični primer v angleščini
Create a four-stage growing guide\n\nCreate a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants.An image with four distinct growing stages in the specified order and a consistent illustration style.Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants.google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) ustvarja in ureja slike iz besedila in vizualnih referenc. Njegove dokumentirane prednosti vključujejo doslednost motivov, besedilo v sliki in lokalizacijo, spremembe skozi pogovor ter ustvarjalni nadzor nad kompozicijo, razmerjem stranic in ločljivostjo.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Nano Banana 2 je Googlov model Gemini 3.1 Flash Image za ustvarjanje slik in urejanje skozi pogovor. Ta vnos ohranja natančno identiteto Preview. Pisni opis lahko določi nov vizualni prikaz, vhodna slika pa motiv, videz ali kompozicijo, ki jo je treba spremeniti. Rezultat lahko vsebuje sliko in spremljevalno besedilo. Googlovo gradivo ob predstavitvi poudarja znanje o svetu, izris besedila in doslednost motivov ter možnost izpopolnjevanja prizora skozi povezane izmenjave.
Pri vizualnem ustvarjanju, utemeljenem z viri, lahko dokumentirani model pri ustvarjanju uporabi informacije iz spletnega in slikovnega iskanja. To podpira naloge, kot sta ilustracija po navdihu lokacije ali diagram na podlagi priloženih informacij. Določite izvorna dejstva, ki morajo biti predstavljena, in jih ločite od umetniških odločitev. Ustvarjanje ob pomoči iskanja ne pomeni, da je vsaka podrobnost na končni sliki preverjena trditev. Če mora biti izdelek, znamenitost ali diagram natančen, priložite merodajno referenco in izhod preverite glede nanjo.
Predstavitev opisuje izboljšan izris besedila v sliki in lokalizacijo. Pri plakatu, infografiki ali marketinški maketi podajte natančno ubeseditev, jezik in vlogo vsakega besedilnega elementa. Najprej dokončno določite besedilo, nato zahtevajte vizualni prikaz, ki ga vsebuje, kot priporoča vodnik za slike. Pojasnite vrstni red branja in relativne poudarke, da se naslov, pripis in oznaka diagrama ne zamenjajo. Pred uporabo slike v objavi preverite pravopis, ločila in povezavo med oznako ter prikazanim elementom.
Ustvarjalne nastavitve vključujejo razmerje stranic in ločljivost. Predstavitev poleg možnosti 1K, 2K in 4K dodaja izhod s 512 slikovnimi pikami ter razmerja stranic 4:1, 1:4, 8:1 in 1:8. Vodnik za razvijalce določa minimal kot privzeto raven razmišljanja in high kot možnost za zahtevnejše kompozicije. Pred kompozicijo izberite predvideno uporabo: pokončna zgodba, široka pasica in strnjen diagram potrebujejo različen prostor za motiv in morebitno besedilo. Te nastavitve opisujejo proizvajalčev postopek ustvarjanja za to linijo, ne samodejnega spreminjanja velikosti že dokončanega izdelka.
Za doslednost motivov označite vlogo vsake reference: videz izdelka, identiteta lika, ozadje ali vizualni slog. Navedite podrobnosti, ki jih je treba ohraniti, nato pa elemente, ki jih je treba spremeniti. Izvirna naloga lahko priloženo fotografijo izdelka umesti v nov prizor ter ohrani njegovo obliko, material in vidne oznake znamke. Pri ilustriranem zaporedju ohranite iste reference in določite, katere podrobnosti se med prizori spreminjajo. Več referenc ne nadomesti jasnega navodila, kaj prispeva vsaka slika.
Urejanje skozi pogovor je uporabno za konkretno spremembo. Zahtevajte prilagoditev enega predmeta, ozadja ali osvetlitve ob ohranitvi sprejete kompozicije. Proizvajalčev vodnik opisuje semantično maskiranje, pri katerem je urejano območje opredeljeno z besedami. Pri delu v več izmenjavah ohranite pogovor in zahtevane metapodatke konteksta sklepanja v izbranem vmesniku; vodnik Gemini 3 pojasnjuje, da podpisi razmišljanja pomagajo prenašati ta kontekst. Opis nespremenjenega območja je navodilo, ki ga je treba preveriti glede na izvirnik, ne jamstvo, da vsaka slikovna pika ostane enaka.
Preglednica za razvijalce Gemini 3 izrecno navaja gemini-3.1-flash-image-preview z vhodnim obsegom 128K in izhodnim obsegom 32K. Pri beleženju ustvarjanja ohranite natančno ime modela Preview. Razpoložljive nastavitve referenc, izhoda in ločljivosti hranite skupaj z izvornimi slikami in zahtevo, da je spremembo mogoče dosledno ponoviti. Pri spremembi ohranite iste izvorne reference in določite natančno vizualno spremembo ter obdržite sprejeto vlogo vsakega vhoda.
Vodnik za slike opozarja, da zahtevano število slik morda ne bo vedno upoštevano, in navaja označevanje ustvarjenih slik s SynthID. Preverite vse vrnjene slike in morebitno spremljevalno besedilo, namesto da bi domnevali, da je rezultat ena določena slika. Pri predvideni velikosti prikaza preverite identiteto motiva, število predmetov, besedilo v sliki, kompozicijo in zvestobo referencam. Pri zahtevnem prizoru navedite sestavne dele v logičnem vrstnem redu in želeni videz opišite s pozitivnimi navodili. Uporaben rezultat je pregledan vizualni izdelek, pri katerem so za naslednje urejanje ohranjene izvorne reference in natančna identiteta modela.
POST /v1/chat/completionstexttext| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-flash-image-preview | Privzeto— |
Poljemessages | Vrstamessage[] | ZahtevaObvezno | Vrednosti in omejitve Najmanjše število elementov: 1 | Privzeto— |
Poljemessages[].role | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Primeri: system, user, assistant, tool, function Pogoji: Te vloge so izrecno predstavljene s tipi združljivosti v izvorni kodi; natančen nabor vlog ostaja odvisen od modela. Odvisno od modela | Privzeto— |
Poljemessages[].content | Vrstastring|content_part[]|null | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].tool_calls | Vrstatool_call[] | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].tool_call_id | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: role=tool; uporabite dejansko vrnjeni ID | Privzeto— |
Poljemessages[].name | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].reasoning_content | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Velja, ko: Pošljite nazaj dejansko vrnjeno sklepanje, kadar ga ta model uporablja | Privzeto— |
Poljemessages[].reasoning_details | Vrstaobject|array | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemax_tokens | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— |
Poljemax_completion_tokens | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Odvisno od modela | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Poljestream_options.include_usage | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetemperature | Vrstanumber | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetop_p | Vrstanumber | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljestop | Vrstastring|string[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetools | Vrstafunction_tool[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljetools[].type | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve function Odvisno od modela | Privzeto— |
Poljetools[].function.name | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Velja, ko: podano je funkcijsko orodje | Privzeto— |
Poljetools[].function.description | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetools[].function.parameters | VrstaJSON_schema | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
Poljetool_choice | Vrstastring|object | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeparallel_tool_calls | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeresponse_format | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljereasoning_effort | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljereasoning | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeservice_tier | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeinstructions | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Polje združljivosti | Privzeto— |
Poljefunctions | Vrstafunction[] | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljefunction_call | Vrstastring|object | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljeprompt_cache_options | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Odvisno od modela | Privzeto— |
Poljemodalities | Vrstastring[] | ZahtevaIzbirno | Vrednosti in omejitve text | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: provider.options je na tej besedilni poti Ultra zavrnjen | Privzeto— |
Poljecache_control.ttl | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: 1h je zavrnjen na dejanskih mestih za predpomnjenje pozivov | Privzeto— |
Besedilo · Besedilo UTF8
messages[].content
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, messages |
Parametermaterial_types | Specifikacijatext |
Parametermessages | Specifikacijapolje sporočil s strukturo role/content |
Parameterfile_material | Specifikacijadejanski dokument UTF-8 je vstavljen kot dobesedno besedilo; ID datoteke se ne izpeljuje |
Parameteroptional_controls | Specifikacijastream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Specifikacijaodvisno od modela; uporabniška funkcijska orodja se razlikujejo od orodij, ki jih izvaja storitev |
Parameteroutput_modalities | Specifikacijatext |
Parameterhosted_operations | Specifikacijafalse |
Parametermultimodal_input_binding | Specifikacijanull |
Življenjski cikel: synchronous_or_streamed
Pošljite natančen ID modela skupaj z messages.
Dolžina konteksta ni zgornja meja izhoda.
Besedilna datoteka lahko poda dobesedno besedilo; slikovni, zvočni vhodi in vhodi z datotečnimi objekti potrebujejo natančno vezavo.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.001 / 1K žetonov Izhod · Izhodni žetoni $0.006 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov Izhod · Izhodni žetoni slike $0.12 / 1K slikovnih žetonov |
| NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.001 / 1K žetonov Izhod · Izhodni žetoni $0.006 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod 0,001 $ / 1K žetonov Izhod · Izhod 0,12 $ / 1K žetonov |
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod 0,001 $ / 1K žetonov Izhod · Izhod 0,12 $ / 1K žetonov |
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod 0,00 $ na klic Izhod · Izhod 0,16 $ na klic |
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod 0,00 $ na klic Izhod · Izhod 0,32 $ na klic |
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| Nastavitevgoogle/gemini-3.1-flash-image-preview · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhod 0,00 $ na klic Izhod · Izhod 0,00 $ na klic |
| Nastavitev | Obračunski pogoji | Strošek |
|---|---|---|
| NastavitevGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Privzeta konfiguracija | Obračunski pogojiPrivzeta konfiguracija | Strošek Vhod · Vhodni žetoni 0,001 $ / 1K žetonov Izhod · Izhodni žetoni 0,006 $ / 1K žetonov Izhod · Izhodna slika 0,12 $ / 1K žetonov Izhod · Iskanje po spletu 0,028 $ na iskanje |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
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-preview", "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-preview',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-preview',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 ali SSE
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohranite vsako možnost odgovora ter njeno vsebino, klice orodij in sklepanje. V SSE sestavite delne spremembe po indeksu možnosti/orodja ter ohranite končni razlog zaključka in podatke o porabi.
Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan.
| Polje | Vrsta |
|---|---|
Poljechoices[].index | Vrstainteger |
Poljechoices[].message.content | Vrstastring|null |
Poljechoices[].message.tool_calls | Vrstatool_call[] |
Poljechoices[].message.reasoning_content | Vrstastring |
Poljechoices[].message.reasoning_details | Vrstaobject|array |
Poljechoices[].finish_reason | Vrstastring|null |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Ailoot Ultra google/gemini-3.1-flash-image-preview
/v1/images
google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) ustvarja in ureja slike iz besedila in vizualnih referenc. Njegove dokumentirane prednosti vključujejo doslednost motivov, besedilo v sliki in lokalizacijo, spremembe skozi pogovor ter ustvarjalni nadzor nad kompozicijo, razmerjem stranic in ločljivostjo.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Nano Banana 2 je Googlov model Gemini 3.1 Flash Image za ustvarjanje slik in urejanje skozi pogovor. Ta vnos ohranja natančno identiteto Preview. Pisni opis lahko določi nov vizualni prikaz, vhodna slika pa motiv, videz ali kompozicijo, ki jo je treba spremeniti. Rezultat lahko vsebuje sliko in spremljevalno besedilo. Googlovo gradivo ob predstavitvi poudarja znanje o svetu, izris besedila in doslednost motivov ter možnost izpopolnjevanja prizora skozi povezane izmenjave.
Pri vizualnem ustvarjanju, utemeljenem z viri, lahko dokumentirani model pri ustvarjanju uporabi informacije iz spletnega in slikovnega iskanja. To podpira naloge, kot sta ilustracija po navdihu lokacije ali diagram na podlagi priloženih informacij. Določite izvorna dejstva, ki morajo biti predstavljena, in jih ločite od umetniških odločitev. Ustvarjanje ob pomoči iskanja ne pomeni, da je vsaka podrobnost na končni sliki preverjena trditev. Če mora biti izdelek, znamenitost ali diagram natančen, priložite merodajno referenco in izhod preverite glede nanjo.
Predstavitev opisuje izboljšan izris besedila v sliki in lokalizacijo. Pri plakatu, infografiki ali marketinški maketi podajte natančno ubeseditev, jezik in vlogo vsakega besedilnega elementa. Najprej dokončno določite besedilo, nato zahtevajte vizualni prikaz, ki ga vsebuje, kot priporoča vodnik za slike. Pojasnite vrstni red branja in relativne poudarke, da se naslov, pripis in oznaka diagrama ne zamenjajo. Pred uporabo slike v objavi preverite pravopis, ločila in povezavo med oznako ter prikazanim elementom.
Ustvarjalne nastavitve vključujejo razmerje stranic in ločljivost. Predstavitev poleg možnosti 1K, 2K in 4K dodaja izhod s 512 slikovnimi pikami ter razmerja stranic 4:1, 1:4, 8:1 in 1:8. Vodnik za razvijalce določa minimal kot privzeto raven razmišljanja in high kot možnost za zahtevnejše kompozicije. Pred kompozicijo izberite predvideno uporabo: pokončna zgodba, široka pasica in strnjen diagram potrebujejo različen prostor za motiv in morebitno besedilo. Te nastavitve opisujejo proizvajalčev postopek ustvarjanja za to linijo, ne samodejnega spreminjanja velikosti že dokončanega izdelka.
Za doslednost motivov označite vlogo vsake reference: videz izdelka, identiteta lika, ozadje ali vizualni slog. Navedite podrobnosti, ki jih je treba ohraniti, nato pa elemente, ki jih je treba spremeniti. Izvirna naloga lahko priloženo fotografijo izdelka umesti v nov prizor ter ohrani njegovo obliko, material in vidne oznake znamke. Pri ilustriranem zaporedju ohranite iste reference in določite, katere podrobnosti se med prizori spreminjajo. Več referenc ne nadomesti jasnega navodila, kaj prispeva vsaka slika.
Urejanje skozi pogovor je uporabno za konkretno spremembo. Zahtevajte prilagoditev enega predmeta, ozadja ali osvetlitve ob ohranitvi sprejete kompozicije. Proizvajalčev vodnik opisuje semantično maskiranje, pri katerem je urejano območje opredeljeno z besedami. Pri delu v več izmenjavah ohranite pogovor in zahtevane metapodatke konteksta sklepanja v izbranem vmesniku; vodnik Gemini 3 pojasnjuje, da podpisi razmišljanja pomagajo prenašati ta kontekst. Opis nespremenjenega območja je navodilo, ki ga je treba preveriti glede na izvirnik, ne jamstvo, da vsaka slikovna pika ostane enaka.
Preglednica za razvijalce Gemini 3 izrecno navaja gemini-3.1-flash-image-preview z vhodnim obsegom 128K in izhodnim obsegom 32K. Pri beleženju ustvarjanja ohranite natančno ime modela Preview. Razpoložljive nastavitve referenc, izhoda in ločljivosti hranite skupaj z izvornimi slikami in zahtevo, da je spremembo mogoče dosledno ponoviti. Pri spremembi ohranite iste izvorne reference in določite natančno vizualno spremembo ter obdržite sprejeto vlogo vsakega vhoda.
Vodnik za slike opozarja, da zahtevano število slik morda ne bo vedno upoštevano, in navaja označevanje ustvarjenih slik s SynthID. Preverite vse vrnjene slike in morebitno spremljevalno besedilo, namesto da bi domnevali, da je rezultat ena določena slika. Pri predvideni velikosti prikaza preverite identiteto motiva, število predmetov, besedilo v sliki, kompozicijo in zvestobo referencam. Pri zahtevnem prizoru navedite sestavne dele v logičnem vrstnem redu in želeni videz opišite s pozitivnimi navodili. Uporaben rezultat je pregledan vizualni izdelek, pri katerem so za naslednje urejanje ohranjene izvorne reference in natančna identiteta modela.
POST /v1/images/generationstext, imageimage| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-flash-image-preview | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
Poljeresolution | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 512, 1K, 2K, 4K | Privzeto— |
Poljeaspect_ratio | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 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 | Privzeto— |
Poljen | Vrstainteger | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1 | Privzeto— |
Poljeinput_references | Vrstaarray | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 14 | Privzeto— |
Poljeprovider | Vrstaobject | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parametermaterial_types | Specifikacijatext, image |
Življenjski cikel: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Dejansko vrnjeni task_id ali zapis v medijski knjižnici
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Strošek |
|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.49152 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
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-preview', '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\nPrenesite vsako vrnjeno sliko ali shranite njeno vsebino 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.\nShranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.
Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.
Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task_id/asset_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.
| Polje | Vrsta |
|---|---|
Poljecreated | Vrsta |
Poljedata[].url | Vrsta |
Poljedata[].b64_json | Vrsta |
Poljeusage | Vrsta |
Ailoot Ultra google/gemini-3.1-flash-image-preview
/v1/images
google/gemini-3.1-flash-image-previewNano Banana 2 (Gemini 3.1 Flash Image Preview) ustvarja in ureja slike iz besedila in vizualnih referenc. Njegove dokumentirane prednosti vključujejo doslednost motivov, besedilo v sliki in lokalizacijo, spremembe skozi pogovor ter ustvarjalni nadzor nad kompozicijo, razmerjem stranic in ločljivostjo.
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
Nano Banana 2 je Googlov model Gemini 3.1 Flash Image za ustvarjanje slik in urejanje skozi pogovor. Ta vnos ohranja natančno identiteto Preview. Pisni opis lahko določi nov vizualni prikaz, vhodna slika pa motiv, videz ali kompozicijo, ki jo je treba spremeniti. Rezultat lahko vsebuje sliko in spremljevalno besedilo. Googlovo gradivo ob predstavitvi poudarja znanje o svetu, izris besedila in doslednost motivov ter možnost izpopolnjevanja prizora skozi povezane izmenjave.
Pri vizualnem ustvarjanju, utemeljenem z viri, lahko dokumentirani model pri ustvarjanju uporabi informacije iz spletnega in slikovnega iskanja. To podpira naloge, kot sta ilustracija po navdihu lokacije ali diagram na podlagi priloženih informacij. Določite izvorna dejstva, ki morajo biti predstavljena, in jih ločite od umetniških odločitev. Ustvarjanje ob pomoči iskanja ne pomeni, da je vsaka podrobnost na končni sliki preverjena trditev. Če mora biti izdelek, znamenitost ali diagram natančen, priložite merodajno referenco in izhod preverite glede nanjo.
Predstavitev opisuje izboljšan izris besedila v sliki in lokalizacijo. Pri plakatu, infografiki ali marketinški maketi podajte natančno ubeseditev, jezik in vlogo vsakega besedilnega elementa. Najprej dokončno določite besedilo, nato zahtevajte vizualni prikaz, ki ga vsebuje, kot priporoča vodnik za slike. Pojasnite vrstni red branja in relativne poudarke, da se naslov, pripis in oznaka diagrama ne zamenjajo. Pred uporabo slike v objavi preverite pravopis, ločila in povezavo med oznako ter prikazanim elementom.
Ustvarjalne nastavitve vključujejo razmerje stranic in ločljivost. Predstavitev poleg možnosti 1K, 2K in 4K dodaja izhod s 512 slikovnimi pikami ter razmerja stranic 4:1, 1:4, 8:1 in 1:8. Vodnik za razvijalce določa minimal kot privzeto raven razmišljanja in high kot možnost za zahtevnejše kompozicije. Pred kompozicijo izberite predvideno uporabo: pokončna zgodba, široka pasica in strnjen diagram potrebujejo različen prostor za motiv in morebitno besedilo. Te nastavitve opisujejo proizvajalčev postopek ustvarjanja za to linijo, ne samodejnega spreminjanja velikosti že dokončanega izdelka.
Za doslednost motivov označite vlogo vsake reference: videz izdelka, identiteta lika, ozadje ali vizualni slog. Navedite podrobnosti, ki jih je treba ohraniti, nato pa elemente, ki jih je treba spremeniti. Izvirna naloga lahko priloženo fotografijo izdelka umesti v nov prizor ter ohrani njegovo obliko, material in vidne oznake znamke. Pri ilustriranem zaporedju ohranite iste reference in določite, katere podrobnosti se med prizori spreminjajo. Več referenc ne nadomesti jasnega navodila, kaj prispeva vsaka slika.
Urejanje skozi pogovor je uporabno za konkretno spremembo. Zahtevajte prilagoditev enega predmeta, ozadja ali osvetlitve ob ohranitvi sprejete kompozicije. Proizvajalčev vodnik opisuje semantično maskiranje, pri katerem je urejano območje opredeljeno z besedami. Pri delu v več izmenjavah ohranite pogovor in zahtevane metapodatke konteksta sklepanja v izbranem vmesniku; vodnik Gemini 3 pojasnjuje, da podpisi razmišljanja pomagajo prenašati ta kontekst. Opis nespremenjenega območja je navodilo, ki ga je treba preveriti glede na izvirnik, ne jamstvo, da vsaka slikovna pika ostane enaka.
Preglednica za razvijalce Gemini 3 izrecno navaja gemini-3.1-flash-image-preview z vhodnim obsegom 128K in izhodnim obsegom 32K. Pri beleženju ustvarjanja ohranite natančno ime modela Preview. Razpoložljive nastavitve referenc, izhoda in ločljivosti hranite skupaj z izvornimi slikami in zahtevo, da je spremembo mogoče dosledno ponoviti. Pri spremembi ohranite iste izvorne reference in določite natančno vizualno spremembo ter obdržite sprejeto vlogo vsakega vhoda.
Vodnik za slike opozarja, da zahtevano število slik morda ne bo vedno upoštevano, in navaja označevanje ustvarjenih slik s SynthID. Preverite vse vrnjene slike in morebitno spremljevalno besedilo, namesto da bi domnevali, da je rezultat ena določena slika. Pri predvideni velikosti prikaza preverite identiteto motiva, število predmetov, besedilo v sliki, kompozicijo in zvestobo referencam. Pri zahtevnem prizoru navedite sestavne dele v logičnem vrstnem redu in želeni videz opišite s pozitivnimi navodili. Uporaben rezultat je pregledan vizualni izdelek, pri katerem so za naslednje urejanje ohranjene izvorne reference in natančna identiteta modela.
POST /v1/messagestextjson, sse| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve google/gemini-3.1-flash-image-preview | Privzeto— |
Poljemessages | Vrstamessage[] | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljemessages[].role | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve user, assistant | Privzeto— |
Poljemessages[].content | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljemax_tokens | Vrstainteger | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
Poljestream | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve | Privzetofalse |
Besedilo · Besedilo UTF-8
niz messages[].content
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, messages, max_tokens |
Parameteroptional_controls | Specifikacijastream |
Parametermaterial_types | Specifikacijatext |
Parametertext_file_material | SpecifikacijaPreberite dejanski dokument UTF-8 in njegovo besedilo vstavite v navedeni vhodni niz ali niz vsebine sporočila. |
Življenjski cikel: synchronous_or_streamed
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Žetonov konteksta več kot | Žetonov konteksta do vključno | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene za žetone | Cenovna lestvicaOsnovna cena | Žetonov konteksta več kot— | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.001 / 1K žetonov Izhod · Izhodni žetoni $0.006 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov Izhod · Izhodni žetoni slike $0.12 / 1K slikovnih žetonov |
| NastavitevRazred 1 glede na dolžino zahteve | Cenovna lestvica— | Žetonov konteksta več kot0 | Žetonov konteksta do vključnoBrez zgornje meje | Strošek Vhod · Vhodni žetoni $0.001 / 1K žetonov Izhod · Izhodni žetoni $0.006 / 1K žetonov Vhod · Branje predpomnilnika — / 1K žetonov Vhod · Zapis v predpomnilnik — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura — / 1K žetonov |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
{\n "model": "google/gemini-3.1-flash-image-preview",\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-preview', '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-preview', '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 ali SSE
Shranite vsak v celoti vrnjen odgovor, datoteko in del vsebine.
Ohranite vse vsebinske bloke, podpise sklepanja in dejanske ID uporabe orodij. Sestavite vse delne spremembe blokov SSE; prvi besedilni blok ni celoten izhod.
Ohranite ID zahtev/odgovorov in glave. Splošni URL za pridobivanje besedilne naloge ni podan.
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljemodel | Vrstastring |
Poljecontent[] | Vrstatext|thinking|tool_use|other content block |
Poljestop_reason | Vrstastring|null |
Poljeusage | Vrstaobject |
| Odgovor | Pogoj | Naslednji korak |
|---|---|---|
Odgovor400 · invalid_request_error | PogojNeveljavna obvezna polja, predstavitev gradiva ali vrednost parametra | Naslednji korakPred novo zahtevo za ustvarjanje popravite navedena polja. |
Ailoot Ultra google/gemini-3.1-flash-image-preview
/v1/images
Tehnični primer v angleščini
Create a four-stage growing guide\n\nCreate a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants.An image with four distinct growing stages in the specified order and a consistent illustration style.Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants.