Logo LlamaGen

Quy trình Nano Banana 2.1

Chạy Nano Banana 2.1 qua API tạo ảnh của Google Cloud

Một script cục bộ có thể gửi yêu cầu trực tiếp đến Google Cloud. Hãy làm rõ xác thực, chọn mô hình, cài đặt ảnh và xử lý kết quả để một phản hồi lỗi về ảnh không âm thầm biến thành một lần xuất thành công.

Bạn sẽ tạo gì

Một yêu cầu SDK trực tiếp và danh sách kiểm tra đánh giá cho một project Google Cloud do bạn kiểm soát. Đây không phải quyền truy cập vào API công khai của LlamaGen.

Tạo bằng Nano Banana 2.1

Nano Banana 2.1 yêu cầu gói LlamaGen trả phí. Hãy kiểm tra mức tính credit hiện tại và các tùy chọn xuất trước khi tạo. Phí sử dụng Google Cloud API trực tiếp được tính riêng. Gói và credit

Một hình ảnh do AI tạo ra đã hoàn thiện, được đặt trong bối cảnh sáng tạo đời thường.
Concept trình bày bằng AI: một hình ảnh hoàn chỉnh được thể hiện trong ngữ cảnh sử dụng. Cảnh này tách biệt với đầu ra trực tiếp của mô hình bên dưới.

Ảnh hero là một concept trình bày do AI tạo ra, cho thấy kết quả hoàn chỉnh trong bối cảnh sử dụng. Đây không phải ảnh chụp khách hàng, ảnh chụp màn hình ứng dụng hay một bài kiểm tra riêng về hiệu năng của mô hình.

Tài nguyên biên tập của LlamaGen

Nội dung đã được rà soát:

Xem một ví dụ đã tạo

Ví dụ bên dưới là đầu ra trực tiếp từ mô hình trong quy trình tạo đã được ghi lại. Hãy xem chính hình ảnh thực tế, thay vì mặc định rằng mô hình đã làm đúng mọi chỉ dẫn.

Ảnh tham chiếu dùng trong quy trình tạo

Đây là các tài nguyên tham chiếu hư cấu do chúng tôi sở hữu. Việc sử dụng chúng không đảm bảo đầu ra giữ nguyên danh tính hoặc chi tiết sản phẩm.

Đầu ra tạo ảnh trực tiếp bằng Nano Banana 2.1 cho quy trình được mô tả trên trang này.
Một đầu ra trực tiếp từ Nano Banana 2.1 theo quy trình đã ghi nhận. Hãy kiểm tra hình ảnh dựa trên các tiêu chí trong hướng dẫn này.

Chuẩn bị quyền truy cập Google Cloud của riêng bạn

Tài liệu hiện tại của Google gọi nền tảng này là Gemini Enterprise Agent Platform; nhiều nhà phát triển vẫn tìm bằng tên cũ Vertex AI. Mẫu ở đây dùng @google/genai 1.45.0, phiên bản được cài trong quy trình tạo cục bộ của chúng tôi, với vertexai: true. Các bản SDK mới hơn có thể đổi tên tuỳ chọn; hãy theo tài liệu của phiên bản bạn đang cài.

Dùng một project đã bật thanh toán, bật dịch vụ cần thiết và có thông tin xác thực được cấp quyền cho yêu cầu. Giữ file service account và access token ngoài mã nguồn, nội dung trang và prompt ảnh. Phí Cloud API tách biệt với mọi gói LlamaGen.

  • Dùng chính xác model ID gemini-nano-banana-2.1.
  • Sử dụng vị trí global được nêu trong tài liệu của mô hình này.
  • Làm theo hướng dẫn xác thực và thiết lập project của Google cho môi trường của bạn.

Gửi các cài đặt mà endpoint này hỗ trợ

Với Cloud model này, các kích thước đầu ra được ghi nhận là 1K, 2K và 4K. Trang Cloud model hiện tại liệt kê tối đa 14 ảnh đầu vào cho mỗi prompt và giới hạn 7 MB cho mỗi tệp với dữ liệu ảnh inline; đầu vào từ Cloud Storage có giới hạn khác. Đây là giới hạn theo endpoint, không phải cam kết rằng mọi tổ hợp đều là một brief sáng tạo tốt.

Tài liệu Cloud nêu rõ seed, temperature, topP, topK và logprobs không được hỗ trợ cho Nano Banana 2.1. Đừng sao chép các cài đặt đó từ ví dụ tạo văn bản hoặc coi seed là một cơ chế kiểm soát khả năng tái lập cho mô hình này.

  • Giữ prompt và một bộ ảnh tham chiếu nhỏ, liên quan để dễ kiểm tra.
  • Dùng MIME type khớp với byte đầu vào thực tế.
  • Ghi model, cài đặt đầu ra và hash của ảnh tham chiếu cùng với kết quả của bạn.

Kiểm tra xem có ảnh thực sự được trả về không

Kiểm tra các phần phản hồi có dữ liệu ảnh inline trước khi ghi file đầu ra. Một phản hồi dạng text, kết quả bị lọc hoặc phản hồi không có ảnh nên được xem là kết quả cần kiểm tra, không phải một lần tạo đã hoàn tất.

Đừng thử lại một cách mù quáng. Hãy lưu metadata không nhạy cảm của yêu cầu và trạng thái phản hồi, kiểm tra các giới hạn đã ghi nhận, rồi xem xét nguyên nhân được trả về. Nếu bạn thử lại một lỗi mơ hồ, hãy hiểu trước cách tính phí hiện tại của nhà cung cấp.

  • Không ghi log thông tin xác thực hoặc toàn bộ ảnh đầu vào riêng tư.
  • Giữ nguyên MIME type của ảnh trả về khi chọn phần mở rộng file.
  • Coi ảnh trả về là một ứng viên vẫn cần được duyệt bằng mắt.

Tách các phần đang thay đổi

Các kiểm tra này mô tả đường đi Google Cloud trực tiếp. Chúng không cấp quyền truy cập API và cũng không thay thế tài liệu thiết lập hiện tại của Google.

Phần của yêu cầuDùng hoặc kiểm traTránh mặc định
Xác thựcProject Google Cloud của riêng bạn đã được cấp quyền và thông tin xác thựcRằng một gói LlamaGen sẽ xác thực yêu cầu Cloud API
Mô hình và khu vựcgemini-nano-banana-2.1 trong globalRằng một tên gọi mô hình tương tự sẽ chọn đúng cùng một mô hình
Cài đặt ảnhTỷ lệ khung hình, kích thước đầu ra và định dạng tham chiếu được hỗ trợRằng seed hoặc các tham số sampling của mô hình văn bản đều được hỗ trợ
Phản hồiByte ảnh thực tế, MIME type và một kết quả có thể đánh giáRằng mọi phản hồi HTTP thành công đều có ảnh có thể đăng

Quy trình thực hành

Từ một yêu cầu nhỏ đến một file có thể kiểm tra

Hãy bắt đầu bằng một yêu cầu tạo ảnh gốc đơn giản. Ví dụ bên dưới theo cấu trúc SDK trực tiếp được dùng trong quy trình tạo cục bộ của chúng tôi; hãy thay môi trường project và xác thực bằng thiết lập đã được phê duyệt của riêng bạn.

Prompt khởi đầu để tùy chỉnh

Tạo một người giao hàng minh hoạ nguyên bản đang cầm đèn lồng trên con phố mưa. Dùng silhouette rõ ràng và khung cảnh dễ đọc. Không thêm chữ hay logo.

Bản tóm tắt này là công thức có thể điều chỉnh, không phải nhật ký yêu cầu nguyên văn cho kết quả được hiển thị. Nó không đảm bảo kết quả giống hệt hoặc tạo ra thành công ngay lần đầu. Bản ghi tạo ảnh sẽ lưu yêu cầu gốc.

Thử quy trình

  1. Chuẩn bị thông tin xác thực và project ở ngoài file nguồn.
  2. Chạy một yêu cầu nhỏ với cài đặt ảnh được hỗ trợ.
  3. Kiểm tra các phần ảnh được trả về, lưu bằng MIME type đúng và xem lại file thực tế.

Cần kiểm tra gì

  • Có phần ảnh nào thực sự được trả về không?
  • File đã lưu có mở đúng không?
  • Hình ảnh có khớp brief đủ tốt để giữ lại không?

Ví dụ SDK Google Cloud trực tiếp

Đây là một yêu cầu Google Cloud trực tiếp bằng project và thông tin xác thực của riêng bạn. Đây không phải endpoint API công khai của LlamaGen. Đừng dán private key vào prompt hoặc trang công khai.

import { GoogleGenAI } from "@google/genai";
import { writeFile } from "node:fs/promises";

// @google/genai 1.45.0, matching the documented local workflow.
// Authenticate outside this file using Google Cloud credentials.
const ai = new GoogleGenAI({
  vertexai: true,
  project: process.env.GOOGLE_CLOUD_PROJECT,
  location: "global",
  httpOptions: { apiVersion: "v1" },
});
const response = await ai.models.generateContent({
  model: "gemini-nano-banana-2.1",
  contents: [{ role: "user", parts: [{
    text: "Create an original illustrated courier carrying a lantern in a rainy street. No text or logos.",
  }] }],
  config: {
    responseModalities: ["IMAGE"],
    candidateCount: 1,
    imageConfig: { aspectRatio: "3:2", imageSize: "2K" },
    thinkingConfig: { thinkingLevel: "HIGH" },
  },
});
const image = response.candidates?.[0]?.content?.parts?.find(
  (part) => part.inlineData?.data,
)?.inlineData;
if (!image?.data) throw new Error("No image returned; inspect the response before retrying.");
const extensions = { "image/png": "png", "image/jpeg": "jpg", "image/webp": "webp" };
const extension = extensions[image.mimeType];
if (!extension) throw new Error("Inspect the returned MIME type before saving.");
await writeFile(`nano-banana-2-1.${extension}`, Buffer.from(image.data, "base64"));

Câu hỏi trước khi bắt đầu

Đây có phải là API công khai của LlamaGen không?

Không. Mã này dùng SDK của Google để gọi trực tiếp Google Cloud bằng dự án và thông tin xác thực của riêng bạn. Trang model trên LlamaGen là một mục sản phẩm riêng.

Có thể đặt seed hoặc temperature không?

Tài liệu model Cloud hiện tại cho biết seed, temperature, topP, topK và logprobs không được hỗ trợ cho Nano Banana 2.1. Hãy kiểm tra tài liệu của endpoint cụ thể trước khi thêm tham số request.

Phản hồi không có ảnh có nghĩa là tôi nên thử lại ngay không?

Hãy xem phản hồi và hướng dẫn hiện tại của nhà cung cấp trước. Bộ lọc, giới hạn và lỗi tạm thời có thể dẫn đến kết quả khác nhau. Hướng dẫn này không cam kết rằng thử lại sẽ thành công hoặc miễn phí.