Source: https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/ Canonical: https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/ Language: ms # Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) [Markdown](https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/index.md) · [JSON](https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/facts.json) ## [Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)](https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/) Nano Banana 2 (Gemini 3.1 Flash Image Preview) menghasilkan dan menyunting imej daripada teks serta rujukan visual. Kekuatan yang didokumenkan merangkumi konsistensi subjek, teks dalam imej dan penyetempatan, perubahan perbualan serta kawalan kreatif ke atas komposisi, nisbah bidang dan resolusi. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/#method-0) - [**Ailoot Ultra · Imej** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/google-gemini-3-1-flash-image-preview/#method-2) Tentang model Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih. Nano Banana 2 ialah model Gemini 3.1 Flash Image Google untuk penjanaan imej dan penyuntingan perbualan. Entri ini mengekalkan identiti Preview yang tepat. Huraian bertulis boleh menetapkan visual baharu, manakala imej input boleh menetapkan subjek, rupa atau komposisi yang hendak diubah. Hasil boleh mengandungi imej dan teks pengiring. Bahan pelancaran Google menekankan pengetahuan dunia, pemaparan teks dan konsistensi subjek, bersama keupayaan memperhalus adegan melalui giliran berkaitan. Untuk penciptaan visual berasaskan sumber, model yang didokumenkan boleh menggunakan maklumat carian web serta imej untuk memaklumkan penjanaan. Ini menyokong tugas seperti ilustrasi berinspirasikan lokasi atau rajah berasaskan maklumat dibekalkan. Tetapkan fakta sumber yang mesti diwakili dan bezakan fakta itu daripada pilihan artistik. Penjanaan berpandukan carian tidak menjadikan setiap butiran gambar akhir pernyataan yang disahkan. Jika produk, mercu tanda atau rajah mesti tepat, berikan rujukan berautoriti dan semak output terhadapnya. Pelancaran menerangkan penambahbaikan pemaparan teks dalam imej serta penyetempatan. Untuk poster, infografik atau mockup pemasaran, berikan ungkapan tepat, bahasa dan peranan setiap elemen teks. Putuskan salinan teks dahulu, kemudian minta visual yang mengandunginya, seperti disyorkan panduan imej. Terangkan turutan bacaan dan penekanan relatif supaya tajuk, kapsyen dan label rajah tidak dikelirukan. Semak ejaan, tanda baca dan hubungan antara label dengan elemen bergambar sebelum menggunakan imej dalam penerbitan. Kawalan kreatif merangkumi nisbah bidang dan resolusi. Pelancaran menambah output 512 piksel bersama pilihan 1K, 2K dan 4K, serta nisbah bidang 4:1, 1:4, 8:1 dan 1:8. Panduan pembangun mengenal pasti pemikiran minimal sebagai lalai dan pemikiran high sebagai pilihan untuk komposisi lebih rumit. Pilih kegunaan sebelum komposisi: story menegak, sepanduk lebar dan rajah padat memerlukan ruang berbeza bagi subjek serta tulisan. Tetapan itu menerangkan aliran penjanaan pembuat untuk barisan ini, bukannya perubahan saiz automatik aset lengkap sedia ada. Untuk konsistensi subjek, labelkan peranan setiap rujukan: rupa produk, identiti watak, latar belakang atau gaya visual. Nyatakan butiran yang perlu dikekalkan, kemudian elemen yang hendak diubah. Tugas asal mungkin meletakkan foto produk dibekalkan dalam adegan baharu sambil mengekalkan bentuk, bahan dan penjenamaan terlihatnya. Untuk urutan ilustrasi, kekalkan rujukan sama dan tetapkan butiran khusus adegan yang berbeza. Rujukan lebih banyak tidak menggantikan arahan jelas tentang sumbangan setiap imej. Penyuntingan perbualan berguna untuk pindaan khusus. Minta pelarasan satu objek, latar belakang atau pencahayaan sambil mengekalkan komposisi diterima. Panduan pembuat menerangkan penentuan kawasan suntingan secara semantik (semantic masking), iaitu kawasan yang hendak disunting dikenal pasti melalui penerangan bertulis. Untuk kerja berbilang giliran, kekalkan perbualan dan metadata konteks penaakulan wajib dalam antara muka terpilih; panduan Gemini 3 menerangkan bahawa tandatangan pemikiran membantu membawa konteks itu. Huraian rantau yang tidak berubah ialah arahan untuk disemak terhadap asal, bukannya jaminan setiap piksel kekal sama. Jadual pembangun Gemini 3 menamakan gemini-3.1-flash-image-preview secara jelas dengan peruntukan input 128K dan output 32K. Kekalkan nama model Preview yang tepat semasa merekodkan penjanaan. Tetapan rujukan, output dan resolusi tersedia perlu disimpan bersama imej sumber serta permintaan supaya pindaan boleh dihasilkan semula secara konsisten. Untuk pindaan, kekalkan rujukan sumber sama dan nyatakan perubahan visual tepat, sambil mengekalkan peranan diterima setiap input. Panduan imej memberi amaran bahawa bilangan imej diminta mungkin tidak sentiasa dipatuhi dan mengenal pasti penandaan SynthID untuk imej terjana. Semak semua imej yang dikembalikan dan sebarang teks pengiring, daripada mengandaikan hasil ialah satu gambar tetap. Periksa identiti subjek, bilangan objek, ungkapan dalam imej, komposisi dan kesetiaan rujukan pada saiz paparan dimaksudkan. Untuk adegan kompleks, tetapkan komponen dalam turutan logik dan terangkan rupa yang diingini secara positif. Hasil berguna ialah aset visual disemak dengan rujukan sumber serta identiti model tepat dikekalkan untuk suntingan seterusnya. Tugas praktikal ### Tugas praktikal Contoh teknikal dalam bahasa Inggeris ``` Create a four-stage growing guide Create 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. ``` #### Hasil yang dijangka ``` An image with four distinct growing stages in the specified order and a consistent illustration style. ``` #### Semak hasil ``` Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) Google /`google/gemini-3.1-flash-image-preview` ### Pengenalan Nano Banana 2 (Gemini 3.1 Flash Image Preview) menghasilkan dan menyunting imej daripada teks serta rujukan visual. Kekuatan yang didokumenkan merangkumi konsistensi subjek, teks dalam imej dan penyetempatan, perubahan perbualan serta kawalan kreatif ke atas komposisi, nisbah bidang dan resolusi. Input yang diterima Teks Hasil Teks ### Tersedia di Ailoot · input & kaedah **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Input `text` Output `text` Format output json atau SSE | Medan | Jenis | Keperluan | Nilai & had | Lalai | | --- | --- | --- | --- | --- | | Medan`model` | Jenis`string` | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image-preview | Lalai— | | Medan`messages` | Jenis`message[]` | KeperluanDiperlukan | Nilai & had Item minimum: 1 | Lalai— | | Medan`messages[].role` | Jenis`string` | KeperluanDiperlukan | Nilai & had Contoh: system, user, assistant, tool, function Syarat: Peranan ini diwakili secara eksplisit oleh jenis keserasian dalam kod sumber; set peranan model yang tepat kekal khusus untuk setiap model. Bergantung pada model | Lalai— | | Medan`messages[].content` | Jenis`string\|content_part[]\|null` | KeperluanPilihan | Nilai & had | Lalai— | | Medan`messages[].tool_calls` | Jenis`tool_call[]` | KeperluanPilihan | Nilai & had | Lalai— | | Medan`messages[].tool_call_id` | Jenis`string` | KeperluanPilihan | Nilai & had Terpakai apabila: role=tool; gunakan ID sebenar yang dipulangkan | Lalai— | | Medan`messages[].name` | Jenis`string` | KeperluanPilihan | Nilai & had | Lalai— | | Medan`messages[].reasoning_content` | Jenis`string` | KeperluanPilihan | Nilai & had Terpakai apabila: Hantar semula penaakulan sebenar yang dipulangkan apabila model ini menggunakannya | Lalai— | | Medan`messages[].reasoning_details` | Jenis`object\|array` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`max_tokens` | Jenis`integer` | KeperluanPilihan | Nilai & had Minimum: 1 Bergantung pada model | Lalai— | | Medan`max_completion_tokens` | Jenis`integer` | KeperluanPilihan | Nilai & had Minimum: 1 Bergantung pada model | Lalai— | | Medan`stream` | Jenis`boolean` | KeperluanPilihan | Nilai & had | Lalaifalse | | Medan`stream_options.include_usage` | Jenis`boolean` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`temperature` | Jenis`number` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`top_p` | Jenis`number` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`stop` | Jenis`string\|string[]` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`tools` | Jenis`function_tool[]` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`tools[].type` | Jenis`string` | KeperluanPilihan | Nilai & had function Bergantung pada model | Lalai— | | Medan`tools[].function.name` | Jenis`string` | KeperluanDiperlukan | Nilai & had Terpakai apabila: alat fungsi dibekalkan | Lalai— | | Medan`tools[].function.description` | Jenis`string` | KeperluanPilihan | Nilai & had | Lalai— | | Medan`tools[].function.parameters` | Jenis`JSON_schema` | KeperluanPilihan | Nilai & had | Lalai— | | Medan`tool_choice` | Jenis`string\|object` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`parallel_tool_calls` | Jenis`boolean` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`response_format` | Jenis`object` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`reasoning_effort` | Jenis`string` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`reasoning` | Jenis`object` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`service_tier` | Jenis`string` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`instructions` | Jenis`string` | KeperluanPilihan | Nilai & had Medan keserasian | Lalai— | | Medan`functions` | Jenis`function[]` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`function_call` | Jenis`string\|object` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`prompt_cache_options` | Jenis`object` | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— | | Medan`modalities` | Jenis`string[]` | KeperluanPilihan | Nilai & had text | Lalai— | | Medan`provider` | Jenis`object` | KeperluanPilihan | Nilai & had Syarat: provider.options ditolak pada laluan teks Ultra ini | Lalai— | | Medan`cache_control.ttl` | Jenis`string` | KeperluanPilihan | Nilai & had Syarat: 1h ditolak pada lokasi cache prompt yang digunakan | Lalai— | Gabungan bahan input **Teks** · Teks UTF8 `messages[].content` Parameter kaedah dan kitar hayat | Parameter | Kontrak | | --- | --- | | Parameter`content_type` | Kontrakapplication/json | | Parameter`required` | Kontrakmodel, messages | | Parameter`material_types` | Kontraktext | | Parameter`messages` | Kontraktatasusunan mesej dengan struktur role/content | | Parameter`file_material` | Kontrakdokumen UTF-8 sebenar dimasukkan sebagai teks literal; ID fail tidak diandaikan | | Parameter`optional_controls` | Kontrakstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parameter`control_scope` | Kontrakkhusus model; alat fungsi pengguna berbeza daripada alat yang dihoskan | | Parameter`output_modalities` | Kontraktext | | Parameter`hosted_operations` | Kontrakfalse | | Parameter`multimodal_input_binding` | Kontraknull | Kitar hayat: `synchronous_or_streamed` Hantar ID model yang tepat bersama messages. Panjang konteks bukan had output. Fail teks boleh membekalkan teks literal; input imej/audio/objek fail memerlukan pengikatan tepat. ### Pelan harga Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih. Mod pantas Kadar standard Apabila mod pantas dipilih Mod flex Kadar standard Apabila mod flex dipilih Usaha penaakulan maksimum Kadar standard Apabila usaha penaakulan maksimum menggunakan pelarasan default Usaha penaakulan · high Kadar standard Apabila usaha penaakulan ditetapkan kepada high Usaha penaakulan · minimal Kadar standard Apabila usaha penaakulan ditetapkan kepada minimal Harga cache eksplisit Tidak diaktifkan Apabila cache eksplisit diminta #### Kadar Ailoot #### Harga mengikut konfigurasi Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif. | Konfigurasi | Jadual kadar | Token konteks, melebihi | Token konteks, sehingga dan termasuk | Caj | | --- | --- | --- | --- | --- | | KonfigurasiKadar asas token | Jadual kadarKadar asas | Token konteks, melebihi— | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input **$0.001** / 1K token Output · Token output **$0.006** / 1K token Input · Bacaan cache **—** / 1K token Input · Penulisan cache **—** / 1K token Input · Penulisan cache, 1 jam **—** / 1K token Output · Token keluaran imej **$0.12** / 1K token imej | | KonfigurasiTahap panjang permintaan 1 | Jadual kadar— | Token konteks, melebihi0 | Token konteks, sehingga dan termasukTiada had atas | Caj Input · Token input **$0.001** / 1K token Output · Token output **$0.006** / 1K token Input · Bacaan cache **—** / 1K token Input · Penulisan cache **—** / 1K token Input · Penulisan cache, 1 jam **—** / 1K token | #### Butiran tarif rujukan Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih. google/gemini-3.1-flash-image-preview #### Harga mengikut konfigurasi | Konfigurasi | Syarat pengebilan | Caj | | --- | --- | --- | | Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.001** / 1K token Output · Output **USD 0.12** / 1K token | google/gemini-3.1-flash-image-preview #### Harga mengikut konfigurasi | Konfigurasi | Syarat pengebilan | Caj | | --- | --- | --- | | Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.001** / 1K token Output · Output **USD 0.12** / 1K token | google/gemini-3.1-flash-image-preview #### Harga mengikut konfigurasi | Konfigurasi | Syarat pengebilan | Caj | | --- | --- | --- | | Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 0.16** bagi setiap panggilan | google/gemini-3.1-flash-image-preview #### Harga mengikut konfigurasi | Konfigurasi | Syarat pengebilan | Caj | | --- | --- | --- | | Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 0.32** bagi setiap panggilan | google/gemini-3.1-flash-image-preview #### Harga mengikut konfigurasi | Konfigurasi | Syarat pengebilan | Caj | | --- | --- | --- | | Konfigurasigoogle/gemini-3.1-flash-image-preview · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 0.00** bagi setiap panggilan | Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) #### Harga mengikut konfigurasi | Konfigurasi | Syarat pengebilan | Caj | | --- | --- | --- | | KonfigurasiGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Token input **USD 0.001** / 1K token Output · Token output **USD 0.006** / 1K token Output · Imej keluaran **USD 0.12** / 1K token Output · Carian web **USD 0.028** setiap carian | Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. [Cara rizab dan penyelesaian caj berfungsi →](https://ailoot.ai/docs/ms/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · OpenAI Chat curlPython SDKPenstriman Python ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=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."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) 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 file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) 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 file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with 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: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Terima dan simpan hasil #### Ailoot Ultra · OpenAI Chat json atau SSE ##### Simpan semua hasil yang selesai Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan. Kekalkan setiap pilihan jawapan bersama kandungan, panggilan alat dan penaakulannya. Dalam SSE, gabungkan delta mengikut indeks pilihan jawapan/alat dan kekalkan sebab penamatan akhir serta data penggunaan. ##### Jika respons asal perlu disemak Kekalkan ID permintaan/respons dan pengepala. Tiada URL umum bagi pengambilan tugas teks dibekalkan. Medan respons | Medan | Jenis | | --- | --- | | Medan`choices[].index` | Jenisinteger | | Medan`choices[].message.content` | Jenisstring\|null | | Medan`choices[].message.tool_calls` | Jenistool\_call\[\] | | Medan`choices[].message.reasoning_content` | Jenisstring | | Medan`choices[].message.reasoning_details` | Jenisobject\|array | | Medan`choices[].finish_reason` | Jenisstring\|null | | Medan`usage` | Jenisobject | Ralat dan langkah seterusnya | Respons | Syarat | Langkah seterusnya | | --- | --- | --- | | Respons400 · `invalid_request_error` | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. | ### Alias #### Alias model **Ailoot Ultra** [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) #### Alias laluan kaedah `/v1/images` #### ID pemanggil berkaitan [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) **Ailoot Ultra · Imej** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/ms/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=images) Google /`google/gemini-3.1-flash-image-preview` ### Pengenalan Nano Banana 2 (Gemini 3.1 Flash Image Preview) menghasilkan dan menyunting imej daripada teks serta rujukan visual. Kekuatan yang didokumenkan merangkumi konsistensi subjek, teks dalam imej dan penyetempatan, perubahan perbualan serta kawalan kreatif ke atas komposisi, nisbah bidang dan resolusi. Input yang diterima Teks · Imej Hasil Imej ### Tersedia di Ailoot · input & kaedah **Ailoot Ultra · Imej** `POST /v1/images/generations` Input `text`, `image` Output `image` | Medan | Jenis | Keperluan | Nilai & had | Lalai | | --- | --- | --- | --- | --- | | Medan`model` | Jenis`string` | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image-preview | Lalai— | | Medan`prompt` | Jenis`string` | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— | | Medan`resolution` | Jenis`string` | KeperluanPilihan | Nilai & had 512, 1K, 2K, 4K | Lalai— | | Medan`aspect_ratio` | Jenis`string` | KeperluanPilihan | Nilai & had 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 | Lalai— | | Medan`n` | Jenis`integer` | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 1 | Lalai— | | Medan`input_references` | Jenis`array` | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 14 | Lalai— | | Medan`provider` | Jenis`object` | KeperluanPilihan | Nilai & had | Lalai— | Parameter kaedah dan kitar hayat | Parameter | Kontrak | | --- | --- | | Parameter`content_type` | Kontrakapplication/json | | Parameter`required` | Kontrakmodel, prompt | | Parameter`material_types` | Kontraktext, image | Kitar hayat: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · task\_id sebenar yang dikembalikan atau rekod pustaka media `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Pelan harga ##### Cara caj akhir dikira Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan. Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih. Mod pantas Tidak dinyatakan Apabila mod pantas dipilih Mod flex Tidak dinyatakan Apabila mod flex dipilih Usaha penaakulan maksimum Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default #### Anggaran kadar untuk perbandingan #### Harga mengikut konfigurasi Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif. | Konfigurasi | Jadual kadar | Kuantiti ramalan | Caj | | --- | --- | --- | --- | | KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja **—** / 1K token Output · Token output · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja **—** / 1K token | | KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja **$0.49152** anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. | Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. [Cara rizab dan penyelesaian caj berfungsi →](https://ailoot.ai/docs/ms/billing/reserve/) ### Contoh permintaan #### Ailoot Ultra · Imej curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-3.1-flash-image-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") 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"