Source: https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/ Canonical: https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/ Language: vi # Google: Nano Banana Pro (Gemini 3 Pro Image Preview) [Markdown](https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/index.md) · [JSON](https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/facts.json) ## [Google: Nano Banana Pro (Gemini 3 Pro Image Preview)](https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/) Nano Banana Pro là mô hình Gemini 3 Pro Image Preview của Google dành cho tạo và chỉnh sửa ảnh. Cấu hình được tài liệu hóa hỗ trợ bố cục từ nhiều ảnh, chữ nhúng trong ảnh, thay đổi sáng tạo cục bộ, grounding bằng Search và đầu ra 2K hoặc 4K. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/#method-0) - [**Ailoot Ultra · Ảnh** `POST /v1/images/generations` `google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/google-gemini-3-pro-image-preview/#method-2) Về mô hình Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn. Nano Banana Pro là mô hình tạo và chỉnh sửa ảnh của Google được xây dựng trên Gemini 3 Pro. Mô hình nhận văn bản và hình ảnh rồi trả về hình ảnh hoặc văn bản. Cấu hình được công bố bao quát đồ họa thông tin, sơ đồ, hình ảnh sản phẩm, bảng phân cảnh và bố cục kết hợp nhiều yếu tố hoặc tham chiếu. #### Bố trí hình ảnh và nội dung hiển thị Nêu mục đích, chủ thể chính và mối quan hệ giữa các yếu tố. Với đồ họa thông tin, cung cấp số liệu thực tế và nhãn chính xác, sau đó mô tả thứ bậc. Với cảnh sản phẩm, xác định đối tượng, góc nhìn, bối cảnh và các chi tiết phải còn nhận ra được. Vai trò hiển thị chữ được tài liệu hóa của mô hình bao gồm câu chữ dài hơn và bố cục đa ngôn ngữ; kiểm tra chữ, số và căn chỉnh trong ảnh trả về. Grounding bằng tìm kiếm được tài liệu hóa để đưa thông tin hiện tại vào tác vụ hình ảnh. Khi giao diện cung cấp tính năng này, giữ các dữ kiện nguồn cùng bản yêu cầu và kiểm tra cách chúng xuất hiện trong đồ họa cuối cùng. Biểu đồ hoặc sơ đồ thuyết phục về mặt thị giác vẫn cần được đối chiếu với dữ liệu và nhãn mà nó dự kiến thể hiện. #### Tham chiếu và chỉnh sửa sáng tạo Cấu hình lưu trữ/phục vụ được công bố nhận tối đa mười bốn ảnh tham chiếu. Gán vai trò cho mỗi ảnh, chẳng hạn chủ thể, bối cảnh hoặc phong cách thị giác, thay vì để quan hệ của chúng không được giải thích. Mô tả mô hình nhấn mạnh việc giữ danh tính của tối đa năm chủ thể; đối chiếu chủ thể thực tế và các chi tiết quan trọng trong toàn bộ bố cục trả về. Khi chỉnh sửa, nêu vùng hoặc đối tượng cần thay đổi và các yếu tố cần giữ. Các điều khiển sáng tạo được tài liệu hóa gồm thay đổi cục bộ, điều chỉnh ánh sáng và tiêu điểm, thay đổi góc nhìn của máy ảnh và tỷ lệ khung hình linh hoạt. Giữ ảnh nguồn sẵn có khi kiểm tra cả thay đổi yêu cầu lẫn chi tiết phải còn nhận ra được. #### Độ phân giải và sản phẩm có thể sử dụng Cấu hình ghi nhận đầu ra 2K và 4K. Chọn tỷ lệ hình ảnh và quy mô đầu ra cho nơi sử dụng dự kiến, sau đó kiểm tra kích thước cùng thuộc tính tệp thực tế trả về. Ý tưởng thiết kế và yêu cầu xuất cần tiếp tục gắn với nhau khi ảnh được đưa vào bố cục lớn hơn. Lưu ảnh được chọn cùng bản yêu cầu, vai trò tham chiếu và lịch sử sửa đổi. Kiểm tra câu chữ chính xác, tính liên tục của chủ thể và thứ bậc thông tin ở kích thước sử dụng tài sản. Sản phẩm hữu ích là hình ảnh đã kiểm tra hoặc văn bản đi kèm từ cấu hình mô hình này, sẵn sàng cho công việc thiết kế hoặc sản xuất tiếp theo. Tác vụ thực tế ### Tác vụ thực tế Ví dụ kỹ thuật bằng tiếng Anh ``` Create a stock comparison infographic Create a clean landscape infographic for a warehouse noticeboard. Title: "Weekly stock". Show exactly three labelled bars: "Boxes 24", "Bags 12", "Tubes 6". Use a white background, dark text and one blue accent. Keep labels large, align the bars to a common baseline and add no extra numbers or logos. ``` #### Kết quả mong đợi ``` One infographic image with the exact title and three proportional, labelled bars on a common baseline. ``` #### Kiểm tra kết quả ``` Inspect all lettering and confirm the bar values and relative lengths match 24, 12 and 6. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3-pro-image-preview` [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=chat) Google /`google/gemini-3-pro-image-preview` ### Bắt đầu Nano Banana Pro là mô hình Gemini 3 Pro Image Preview của Google dành cho tạo và chỉnh sửa ảnh. Cấu hình được tài liệu hóa hỗ trợ bố cục từ nhiều ảnh, chữ nhúng trong ảnh, thay đổi sáng tạo cục bộ, grounding bằng Search và đầu ra 2K hoặc 4K. Đầu vào được chấp nhận Văn bản Kết quả Văn bản ### Có trên Ailoot · đầu vào & phương thức **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Đầu vào `text` Đầu ra `text` Định dạng đầu ra json hoặc SSE | Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định | | --- | --- | --- | --- | --- | | Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn google/gemini-3-pro-image-preview | Mặc định— | | Trường`messages` | Loại`message[]` | Yêu cầuBắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 | Mặc định— | | Trường`messages[].role` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Ví dụ: system, user, assistant, tool, function Điều kiện: Các vai trò này được biểu diễn rõ trong các kiểu tương thích của mã nguồn; tập vai trò chính xác vẫn tùy từng mô hình. Tùy thuộc vào mô hình | Mặc định— | | Trường`messages[].content` | Loại`string\|content_part[]\|null` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`messages[].tool_calls` | Loại`tool_call[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`messages[].tool_call_id` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Áp dụng khi: role=tool; dùng ID thực tế được trả về | Mặc định— | | Trường`messages[].name` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`messages[].reasoning_content` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Áp dụng khi: Gửi lại dữ liệu suy luận thực tế đã được trả về khi mô hình này sử dụng dữ liệu đó | Mặc định— | | Trường`messages[].reasoning_details` | Loại`object\|array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`max_tokens` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tùy thuộc vào mô hình | Mặc định— | | Trường`max_completion_tokens` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tùy thuộc vào mô hình | Mặc định— | | Trường`stream` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc địnhfalse | | Trường`stream_options.include_usage` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`temperature` | Loại`number` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`top_p` | Loại`number` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`stop` | Loại`string\|string[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`tools` | Loại`function_tool[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`tools[].type` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn function Tùy thuộc vào mô hình | Mặc định— | | Trường`tools[].function.name` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Áp dụng khi: Có cung cấp công cụ hàm | Mặc định— | | Trường`tools[].function.description` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`tools[].function.parameters` | Loại`JSON_schema` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | | Trường`tool_choice` | Loại`string\|object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`parallel_tool_calls` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`response_format` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`reasoning_effort` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`reasoning` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`service_tier` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`instructions` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Trường tương thích | Mặc định— | | Trường`functions` | Loại`function[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`function_call` | Loại`string\|object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`prompt_cache_options` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tùy thuộc vào mô hình | Mặc định— | | Trường`modalities` | Loại`string[]` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn text | Mặc định— | | Trường`provider` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: provider.options bị từ chối trên tuyến văn bản Ultra này | Mặc định— | | Trường`cache_control.ttl` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: 1h bị từ chối tại các vị trí lưu đệm prompt thực tế | Mặc định— | Tổ hợp tư liệu đầu vào **Văn bản** · Văn bản UTF8 `messages[].content` Tham số phương thức và vòng đời | Tham số | Hợp đồng | | --- | --- | | Tham số`content_type` | Hợp đồngapplication/json | | Tham số`required` | Hợp đồngmodel, messages | | Tham số`material_types` | Hợp đồngtext | | Tham số`messages` | Hợp đồngMảng thông điệp có cấu trúc role/content | | Tham số`file_material` | Hợp đồngTài liệu UTF-8 thực tế được chèn nguyên dạng văn bản; không suy ra ID tệp | | Tham số`optional_controls` | Hợp đồngstream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Tham số`control_scope` | Hợp đồngTùy từng mô hình; công cụ hàm của người dùng khác với công cụ do dịch vụ cung cấp | | Tham số`output_modalities` | Hợp đồngtext | | Tham số`hosted_operations` | Hợp đồngfalse | | Tham số`multimodal_input_binding` | Hợp đồngnull | Vòng đời: `synchronous_or_streamed` Gửi ID mô hình chính xác cùng messages. Độ dài ngữ cảnh không phải giới hạn đầu ra. Tệp văn bản có thể cung cấp nguyên văn nội dung; đầu vào hình ảnh, âm thanh hoặc đối tượng tệp cần có liên kết chính xác. ### Bảng giá Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn. Chế độ nhanh Mức giá tiêu chuẩn Khi chọn chế độ nhanh Chế độ Flex Mức giá tiêu chuẩn Khi chọn chế độ flex Mức độ suy luận tối đa Mức giá tiêu chuẩn Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa Giá lưu đệm tường minh Chưa bật Khi yêu cầu lưu đệm tường minh #### Mức phí Ailoot #### Giá theo cấu hình Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế. | Cấu hình | Biểu mức phí | Token ngữ cảnh, lớn hơn | Token ngữ cảnh, tối đa và bao gồm | Phí | | --- | --- | --- | --- | --- | | Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Token ngữ cảnh, lớn hơn— | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào **$0.004** / 1K token Đầu ra · Token đầu ra **$0.024** / 1K token Đầu vào · Đọc bộ nhớ đệm **$0.0004** / 1K token Đầu vào · Ghi bộ nhớ đệm **$0.00075** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ **—** / 1K token Đầu ra · Token ảnh đầu ra **$0.24** / 1K token hình ảnh | | Cấu hìnhBậc 1 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn0 | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào **$0.004** / 1K token Đầu ra · Token đầu ra **$0.024** / 1K token Đầu vào · Đọc bộ nhớ đệm **$0.0004** / 1K token Đầu vào · Ghi bộ nhớ đệm **$0.00075** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ **—** / 1K token | #### Chi tiết giá cước tham chiếu Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã chọn. google/gemini-3-pro-image-preview #### Giá theo cấu hình | Cấu hình | Điều kiện tính phí | Phí | | --- | --- | --- | | Cấu hìnhgoogle/gemini-3-pro-image-preview · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào **0,004 US$** / 1K token Đầu ra · Đầu ra **0,24 US$** / 1K token | Google: Nano Banana Pro (Gemini 3 Pro Image Preview) #### Giá theo cấu hình | Cấu hình | Điều kiện tính phí | Phí | | --- | --- | --- | | Cấu hìnhGoogle: Nano Banana Pro (Gemini 3 Pro Image Preview) · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Token đầu vào **0,004 US$** / 1K token Đầu ra · Token đầu ra **0,024 US$** / 1K token Đầu vào · Ảnh đầu vào **0,004 US$** / 1K token Đầu ra · Ảnh đầu ra **0,24 US$** / 1K token Đầu vào · Âm thanh đầu vào **0,004 US$** / 1K token Đầu vào · Đọc bộ nhớ đệm âm thanh **0,0004 US$** / 1K token Đầu ra · Tìm kiếm trên web **0,028 US$** mỗi lượt tìm kiếm Đầu ra · Token suy luận **0,024 US$** / 1K token Đầu vào · Đọc bộ nhớ đệm **0,0004 US$** / 1K token Đầu vào · Ghi bộ nhớ đệm · 5 phút **0,00075 US$** / 1K token | Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/) ### Ví dụ yêu cầu #### Ailoot Ultra · OpenAI Chat curlPython SDKLuồng 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-pro-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-pro-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-pro-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") ``` ### Nhận và lưu kết quả #### Ailoot Ultra · OpenAI Chat json hoặc SSE ##### Lưu tất cả kết quả đã hoàn tất Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về. Giữ mọi phương án trả lời cùng nội dung, lệnh gọi công cụ và dữ liệu suy luận của phương án đó. Với SSE, ghép các phần thay đổi theo chỉ số phương án và công cụ, giữ lý do kết thúc cuối cùng cùng dữ liệu sử dụng. ##### Nếu cần kiểm tra phản hồi gốc Giữ ID và header của yêu cầu, phản hồi. Không cung cấp URL chung để truy xuất tác vụ văn bản. Trường phản hồi | Trường | Loại | | --- | --- | | Trường`choices[].index` | Loạiinteger | | Trường`choices[].message.content` | Loạistring\|null | | Trường`choices[].message.tool_calls` | Loạitool\_call\[\] | | Trường`choices[].message.reasoning_content` | Loạistring | | Trường`choices[].message.reasoning_details` | Loạiobject\|array | | Trường`choices[].finish_reason` | Loạistring\|null | | Trường`usage` | Loạiobject | Lỗi và bước tiếp theo | Phản hồi | Điều kiện | Bước tiếp theo | | --- | --- | --- | | Phản hồi400 · `invalid_request_error` | Điều kiệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. | ### Bí danh #### Bí danh mô hình **Ailoot Ultra** [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=chat) #### Bí danh đường dẫn phương thức `/v1/images` #### ID gọi liên quan [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=chat) **Ailoot Ultra · Ảnh** `POST /v1/images/generations` `google/gemini-3-pro-image-preview` [`google/gemini-3-pro-image-preview`](https://ailoot.ai/models/vi/#m=google%2Fgemini-3-pro-image-preview&route=Ultra&caller=google%2Fgemini-3-pro-image-preview&fmt=images) Google /`google/gemini-3-pro-image-preview` ### Bắt đầu Nano Banana Pro là mô hình Gemini 3 Pro Image Preview của Google dành cho tạo và chỉnh sửa ảnh. Cấu hình được tài liệu hóa hỗ trợ bố cục từ nhiều ảnh, chữ nhúng trong ảnh, thay đổi sáng tạo cục bộ, grounding bằng Search và đầu ra 2K hoặc 4K. Đầu vào được chấp nhận Văn bản · Ảnh Kết quả Ảnh ### Có trên Ailoot · đầu vào & phương thức **Ailoot Ultra · Ảnh** `POST /v1/images/generations` Đầu vào `text`, `image` Đầu ra `image` | Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định | | --- | --- | --- | --- | --- | | Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn google/gemini-3-pro-image-preview | Mặc định— | | Trường`prompt` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— | | Trường`resolution` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1K, 2K, 4K | Mặc định— | | Trường`aspect_ratio` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 | Mặc định— | | Trường`n` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 1 | Mặc định— | | Trường`input_references` | Loại`array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 14 | Mặc định— | | Trường`provider` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— | Tham số phương thức và vòng đời | Tham số | Hợp đồng | | --- | --- | | Tham số`content_type` | Hợp đồngapplication/json | | Tham số`required` | Hợp đồngmodel, prompt | | Tham số`material_types` | Hợp đồngtext, image | Vòng đời: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · Giá trị task\_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Bảng giá ##### Cách tính phí cuối cùng Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí. Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn. Chế độ nhanh Chưa chỉ định Khi chọn chế độ nhanh Chế độ Flex Chưa chỉ định Khi chọn chế độ flex Mức độ suy luận tối đa Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa #### Mức phí ước tính để so sánh #### Giá theo cấu hình Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế. | Cấu hình | Biểu mức phí | Số lượng dự báo | Phí | | --- | --- | --- | --- | | Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh **—** / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh **—** / 1K token | | Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh **$0.98304** ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. | Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/) ### Ví dụ yêu cầu #### Ailoot Ultra · Ảnh 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-pro-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"