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.
", "aboutText": "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.\n\nUntuk 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.\n\nPelancaran 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.\n\nKawalan 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.\n\nUntuk 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.\n\nPenyuntingan 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.\n\nJadual 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.\n\nPanduan 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.", "editorialOverlay": { "copy_fields": { "practical_html": "Contoh teknikal dalam bahasa Inggeris
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) 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.
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.
POST /v1/chat/completionstexttext| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image-preview | Lalai— |
Medanmessages | Jenismessage[] | KeperluanDiperlukan | Nilai & had Item minimum: 1 | Lalai— |
Medanmessages[].role | Jenisstring | 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— |
Medanmessages[].content | Jenisstring|content_part[]|null | KeperluanPilihan | Nilai & had | Lalai— |
Medanmessages[].tool_calls | Jenistool_call[] | KeperluanPilihan | Nilai & had | Lalai— |
Medanmessages[].tool_call_id | Jenisstring | KeperluanPilihan | Nilai & had Terpakai apabila: role=tool; gunakan ID sebenar yang dipulangkan | Lalai— |
Medanmessages[].name | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medanmessages[].reasoning_content | Jenisstring | KeperluanPilihan | Nilai & had Terpakai apabila: Hantar semula penaakulan sebenar yang dipulangkan apabila model ini menggunakannya | Lalai— |
Medanmessages[].reasoning_details | Jenisobject|array | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanmax_tokens | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Bergantung pada model | Lalai— |
Medanmax_completion_tokens | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Bergantung pada model | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Medanstream_options.include_usage | Jenisboolean | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantemperature | Jenisnumber | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantop_p | Jenisnumber | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanstop | Jenisstring|string[] | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantools | Jenisfunction_tool[] | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medantools[].type | Jenisstring | KeperluanPilihan | Nilai & had function Bergantung pada model | Lalai— |
Medantools[].function.name | Jenisstring | KeperluanDiperlukan | Nilai & had Terpakai apabila: alat fungsi dibekalkan | Lalai— |
Medantools[].function.description | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medantools[].function.parameters | JenisJSON_schema | KeperluanPilihan | Nilai & had | Lalai— |
Medantool_choice | Jenisstring|object | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanparallel_tool_calls | Jenisboolean | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanresponse_format | Jenisobject | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanreasoning_effort | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanreasoning | Jenisobject | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanservice_tier | Jenisstring | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medaninstructions | Jenisstring | KeperluanPilihan | Nilai & had Medan keserasian | Lalai— |
Medanfunctions | Jenisfunction[] | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanfunction_call | Jenisstring|object | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanprompt_cache_options | Jenisobject | KeperluanPilihan | Nilai & had Bergantung pada model | Lalai— |
Medanmodalities | Jenisstring[] | KeperluanPilihan | Nilai & had text | Lalai— |
Medanprovider | Jenisobject | KeperluanPilihan | Nilai & had Syarat: provider.options ditolak pada laluan teks Ultra ini | Lalai— |
Medancache_control.ttl | Jenisstring | KeperluanPilihan | Nilai & had Syarat: 1h ditolak pada lokasi cache prompt yang digunakan | Lalai— |
Teks · Teks UTF8
messages[].content
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, messages |
Parametermaterial_types | Kontraktext |
Parametermessages | Kontraktatasusunan mesej dengan struktur role/content |
Parameterfile_material | Kontrakdokumen UTF-8 sebenar dimasukkan sebagai teks literal; ID fail tidak diandaikan |
Parameteroptional_controls | Kontrakstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice |
Parametercontrol_scope | Kontrakkhusus model; alat fungsi pengguna berbeza daripada alat yang dihoskan |
Parameteroutput_modalities | Kontraktext |
Parameterhosted_operations | Kontrakfalse |
Parametermultimodal_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.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
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 |
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 →
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 atau SSE
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.
Kekalkan ID permintaan/respons dan pengepala. Tiada URL umum bagi pengambilan tugas teks dibekalkan.
| Medan | Jenis |
|---|---|
Medanchoices[].index | Jenisinteger |
Medanchoices[].message.content | Jenisstring|null |
Medanchoices[].message.tool_calls | Jenistool_call[] |
Medanchoices[].message.reasoning_content | Jenisstring |
Medanchoices[].message.reasoning_details | Jenisobject|array |
Medanchoices[].finish_reason | Jenisstring|null |
Medanusage | Jenisobject |
| 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. |
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) 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.
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.
POST /v1/images/generationstext, imageimage| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image-preview | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medanresolution | Jenisstring | KeperluanPilihan | Nilai & had 512, 1K, 2K, 4K | Lalai— |
Medanaspect_ratio | Jenisstring | 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— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 1 | Lalai— |
Medaninput_references | Jenisarray | KeperluanPilihan | Nilai & had Item minimum: 0 Item maksimum: 14 | Lalai— |
Medanprovider | Jenisobject | KeperluanPilihan | Nilai & had | Lalai— |
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_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}
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.
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 →
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\nMuat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
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.\nSimpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Simpan respons dan pengepala yang lengkap, setiap output sebenar, pengecam asal yang dikembalikan serta semua medan penggunaan. Pulihkan operasi asal tanpa menghantar permintaan penciptaan sekali lagi.
Simpan X-Client-Request-ID yang dikembalikan untuk penyelarasan rekod. Baca hanya nilai task_id/asset_id sebenar yang dikembalikan atau pustaka media milik anda; jangan sekali-kali bina URL tugas daripada ID operasi atau hantar semula permintaan penciptaan.
| Medan | Jenis |
|---|---|
Medancreated | Jenis |
Medandata[].url | Jenis |
Medandata[].b64_json | Jenis |
Medanusage | Jenis |
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) 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.
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.
POST /v1/messagestextjson, sse| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/gemini-3.1-flash-image-preview | Lalai— |
Medanmessages | Jenismessage[] | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanmessages[].role | Jenisstring | KeperluanDiperlukan | Nilai & had user, assistant | Lalai— |
Medanmessages[].content | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanmax_tokens | Jenisinteger | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had | Lalaifalse |
Teks · Teks UTF-8
rentetan messages[].content
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, messages, max_tokens |
Parameteroptional_controls | Kontrakstream |
Parametermaterial_types | Kontraktext |
Parametertext_file_material | KontrakBaca dokumen UTF-8 sebenar dan letakkan teksnya dalam rentetan input atau kandungan mesej yang ditunjukkan. |
Kitar hayat: synchronous_or_streamed
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
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 |
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 →
{\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 atau SSE
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Kekalkan semua blok kandungan, tandatangan penaakulan dan ID penggunaan alat sebenar. Gabungkan semua delta blok SSE; blok teks pertama bukan keseluruhan output.
Kekalkan ID permintaan/respons dan pengepala. Tiada URL umum bagi pengambilan tugas teks dibekalkan.
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanmodel | Jenisstring |
Medancontent[] | Jenistext|thinking|tool_use|other content block |
Medanstop_reason | Jenisstring|null |
Medanusage | Jenisobject |
| 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. |
Ailoot Ultra google/gemini-3.1-flash-image-preview
/v1/images
Contoh teknikal dalam bahasa Inggeris
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.