# "gemini-3.1-flash-lite-image" Nguồn: https://docs.openaihub.net/api-45208846/ > API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn. ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /v1beta/models/gemini-3.1-flash-lite-image:generateContent: post: summary: gemini-3.1-flash-lite-image deprecated: false description: >- Tài liệu chính thức: https://ai.google.dev/gemini-api/docs/image-generation — Gemini 3.1 Flash-Lite Image (Nano Banana 2 Lite) hỗ trợ chuyển văn bản thành hình ảnh, hình ảnh thành hình ảnh, video thành hình ảnh và chỉnh sửa hình ảnh. operationId: gemini_v1beta_3_1_flash_lite_image_generate_content tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc - Gemini v1beta parameters: - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - contents properties: contents: type: array items: type: object required: - parts properties: parts: type: array items: type: object properties: fileData: type: object required: - mimeType - fileUri properties: fileUri: type: string description: >- URI của tệp phương tiện, chẳng hạn như gs://bucket/object hoặc URI tệp do API Tệp của Google trả về. Ràng buộc từ hệ thống đầu nguồn: Mô hình phải có khả năng truy cập tệp. mimeType: type: string enum: - image/png - image/jpeg - image/webp - video/mp4 enumDetails: - value: image/png displayName: PNG description: Hình ảnh tham chiếu / nguồn để chỉnh sửa - value: image/jpeg displayName: JPEG description: Hình ảnh tham chiếu / nguồn để chỉnh sửa - value: image/webp displayName: WebP description: Hình ảnh tham khảo - value: video/mp4 displayName: MP4 description: Đầu vào video thành hình ảnh description: Loại MIME của tệp. description: >- Các tệp phương tiện được tham chiếu bằng URI, thường được dùng cho các hình ảnh tham khảo được tải lên bằng GCS/File API. x-apifox-orders: - fileUri - mimeType x-apidog-orders: - fileUri - mimeType inlineData: type: object required: - mimeType - data properties: data: type: string description: >- Nội dung phương tiện được mã hóa Base64 không có tiền tố URI dữ liệu. Các giới hạn từ hệ thống nguồn: Tổng kích thước của một tệp đơn lẻ là ≤500MB. mimeType: type: string enum: - image/png - image/jpeg - image/webp - image/gif - video/mp4 - video/quicktime - video/webm enumDetails: - value: image/png displayName: Hình ảnh PNG description: >- Phù hợp cho các trường hợp chỉnh sửa và nền trong suốt - value: image/jpeg displayName: Hình ảnh JPEG description: >- Phù hợp với hình ảnh tham chiếu giống ảnh chụp - value: image/webp displayName: Hình ảnh WebP description: Tham chiếu hình ảnh đã nén - value: image/gif displayName: Hình ảnh GIF description: >- Tham chiếu động; được xử lý như một khung hình tĩnh - value: video/mp4 displayName: Video MP4 description: >- Đầu vào từ video sang hình ảnh; được lấy mẫu ở tốc độ 1 khung hình/giây - value: video/quicktime displayName: Video MOV description: Đầu vào video thành hình ảnh - value: video/webm displayName: Video WebM description: Đầu vào video thành hình ảnh description: >- Loại MIME của phương tiện. image/png, image/jpeg thường được dùng cho hình ảnh; video/mp4 thường được dùng cho video. Ràng buộc từ hệ thống nguồn: Trả về 400 khi định dạng không hợp lệ. description: >- Dữ liệu phương tiện nội tuyến, thường được dùng để tải ảnh/video cục bộ lên bằng Base64. Các giới hạn từ dịch vụ nguồn: Mỗi ảnh được tính phí tương đương 1120 token đầu vào; video được lấy mẫu ở tốc độ 1 khung hình/giây, với 70 token cho mỗi khung hình, và rãnh âm thanh bị bỏ qua. x-apifox-orders: - data - mimeType x-apidog-orders: - data - mimeType text: type: string description: >- Các từ trong lời nhắc văn bản hoặc hướng dẫn chỉnh sửa. Bắt buộc khi tạo ảnh từ văn bản; được sử dụng kết hợp với phần ảnh khi tạo hoặc chỉnh sửa ảnh. anyOf: - type: string - type: string - type: string description: >- Một phần nội dung đơn lẻ bị phân mảnh. Thông thường, chỉ một loại nội dung chính được sử dụng cho cùng một phần. x-apifox-orders: - fileData - inlineData - text x-apidog-orders: - fileData - inlineData - text description: >- Danh sách các đoạn tin nhắn. Mỗi phần chứa ít nhất một trong các trường text, inlineData và fileData. Số lượng ảnh tham chiếu tối đa là 14, và khuyến nghị chính thức là ≤3 để đạt độ nhất quán tốt nhất. role: type: string enum: - user - model enumDetails: - value: user displayName: Người dùng description: >- Dữ liệu đầu vào của người dùng bao gồm văn bản, hình ảnh, video, v.v. - value: mô hình displayName: Mô hình description: >- Phản hồi lịch sử mô hình cho ngữ cảnh chỉnh sửa hình ảnh nhiều lượt description: >- Vai trò của tin nhắn. Mục đầu tiên thường là `user`; bạn có thể luân phiên giữa `user`/`model` trong nhiều vòng chỉnh sửa. x-apifox-orders: - parts - role x-apidog-orders: - parts - role description: >- Danh sách nội dung hội thoại là bắt buộc. Phải bao gồm ít nhất 1 tin nhắn của người dùng khi tạo sơ đồ; phải đính kèm inlineData hoặc fileData vào parts khi tạo/chỉnh sửa sơ đồ; trong nhiều vòng chỉnh sửa, các tin nhắn trước đó phải được thêm vào theo thứ tự thời gian. Các giới hạn của hệ thống thượng nguồn: Tổng số token đầu vào không vượt quá 65536; dữ liệu đầu vào của mỗi tệp không vượt quá 500MB. generationConfig: type: object properties: candidateCount: type: integer description: >- Số lượng kết quả ứng viên. Mô hình này được cố định là 1; các giá trị khác được truyền vào có thể bị bỏ qua hoặc gây ra lỗi. imageConfig: type: object properties: aspectRatio: type: string enum: - '1:1' - '3:2' - '2:3' - '3:4' - '4:3' - '1:4' - '4:1' - '4:5' - '5:4' - '1:8' - '8:1' - '9:16' - '16:9' - '21:9' enumDetails: - value: '1:1' displayName: Hình vuông 1:1 description: >- Mặc định; phù hợp cho bài đăng trên mạng xã hội và ảnh đại diện - value: '3:2' displayName: 3:2 nằm ngang description: Tỷ lệ ảnh ngang tiêu chuẩn - value: '2:3' displayName: Chân dung 2:3 description: Tỷ lệ ảnh chân dung tiêu chuẩn - value: '3:4' displayName: Chân dung 3:4 description: Áp phích khổ dọc - value: '4:3' displayName: Khung ngang 4:3 description: Tỷ lệ khung hình ngang cổ điển - value: '1:4' displayName: Chân dung siêu hẹp 1:4 description: Dải dọc siêu cao - value: '4:1' displayName: khổ ngang siêu rộng 4:1 description: Dải ngang siêu rộng - value: '4:5' displayName: Chân dung 4:5 description: Tỷ lệ ảnh chân dung Instagram phổ biến - value: '5:4' displayName: 5:4 chiều ngang description: Khổ ngang gần vuông - value: '1:8' displayName: 1:8 dọc siêu hẹp description: Hình ảnh cực cao - value: '8:1' displayName: 8:1 khung hình ngang siêu rộng description: Hình ảnh cực rộng - value: '9:16' displayName: 9:16 dọc description: >- Ảnh bìa video ngắn và ảnh chân dung chụp bằng điện thoại - value: '16:9' displayName: 16:9 ngang description: Biểu ngữ, hình thu nhỏ, bài thuyết trình - value: '21:9' displayName: Màn hình siêu rộng 21:9 description: Diện mạo màn ảnh rộng đậm chất điện ảnh description: >- Tỷ lệ khung hình của ảnh đầu ra. Mặc định là 1:1. Chỉ tỷ lệ được thay đổi, không thay đổi độ lớn 1K pixel. imageSize: type: string description: >- Độ phân giải đầu ra. Mô hình này chỉ hỗ trợ 1K (xấp xỉ 1024×1024 pixel). Đầu vào 512, 2K, 4K sẽ bị từ chối hoặc bỏ qua. Bắt buộc phải dùng chữ K viết hoa. outputMimeType: type: string enum: - image/png - image/jpeg - image/webp enumDetails: - value: image/png displayName: PNG description: >- Khuyến nghị mặc định; phù hợp khi cần tính minh bạch - value: image/jpeg displayName: JPEG description: Kích thước nhỏ hơn; phù hợp với đầu ra kiểu ảnh - value: image/webp displayName: WebP description: Định dạng hình ảnh nén cao description: >- Kiểu MIME của ảnh đầu ra. Nếu không được truyền vào, kiểu này sẽ do dịch vụ nguồn quyết định. description: >- Cấu hình tạo ảnh. Mô hình này chỉ hỗ trợ đầu ra 1K; không hỗ trợ 512px / 2K / 4K. x-apifox-orders: - aspectRatio - imageSize - outputMimeType x-apidog-orders: - aspectRatio - imageSize - outputMimeType maxOutputTokens: type: integer description: >- Số lượng token đầu ra tối đa. Đầu ra của mô hình bị giới hạn ở 4096. Đầu ra hình ảnh được tính phí ở mức 1120 token/hình ảnh. responseModalities: type: array items: type: string enum: - IMAGE - TEXT enumDetails: - value: HÌNH ẢNH displayName: Hình ảnh description: >- Dịch tài liệu kỹ thuật này sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ dành sẵn, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không còn ký tự Hán nào. Trả về các hình ảnh đã tạo; bắt buộc đối với việc tạo hình ảnh - value: Vui lòng cung cấp nội dung tài liệu cần dịch. displayName: Vui lòng cung cấp nội dung tài liệu cần dịch. description: >- Cũng có thể trả về ghi chú dạng văn bản; chỉ văn bản sẽ không tạo ra hình ảnh description: >- Danh sách phương thức đầu ra. Phải bao gồm IMAGE khi tạo hình ảnh; nếu cũng cần mô tả bằng văn bản, có thể truyền ["IMAGE", "TEXT"]. Sẽ không trả về hình ảnh khi chỉ truyền TEXT. temperature: type: number description: >- Nhiệt độ lấy mẫu. Giá trị càng cao thì kết quả càng đa dạng. Giá trị mặc định của dịch vụ nguồn là 1.0. thinkingConfig: type: object properties: includeThoughts: type: boolean description: >- Có trả về quá trình suy luận trong phản hồi hay không. Mặc định là false. Phần suy luận được trả về không được hiển thị trong hình ảnh cuối cùng. thinkingLevel: type: string enum: - MINIMAL - HIGH enumDetails: - value: TỐI THIỂU displayName: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. description: >- Giảm thiểu số token dùng cho suy luận; phù hợp với việc tạo hình ảnh đơn giản và độ trễ thấp - value: CAO displayName: >- Vui lòng gửi nội dung tài liệu kỹ thuật cần dịch. description: >- Suy luận nội bộ nhiều hơn; phù hợp với việc soạn nội dung phức tạp và các lời nhắc chi tiết description: >- Cường độ suy luận. Không thể sử dụng cùng với thinkingBudget. description: >- Cấu hình chế độ suy luận, không bắt buộc. Thực hiện suy luận nội bộ trước khi sử dụng chế độ này trong các tác vụ soạn thảo phức tạp. MINIMAL phù hợp khi cần độ trễ thấp; HIGH phù hợp với các lời nhắc phức tạp. Token suy luận được tính vào chi phí đầu ra. x-apifox-orders: - includeThoughts - thinkingLevel x-apidog-orders: - includeThoughts - thinkingLevel topP: type: number description: >- Ngưỡng lấy mẫu kernel. Giá trị mặc định từ nguồn thượng nguồn là 0.95. description: >- Tạo cấu hình. Trong các trường hợp ảnh thô, responseModalities phải chứa IMAGE; imageConfig kiểm soát tỷ lệ khung hình và định dạng đầu ra; thinkingConfig là tùy chọn. x-apifox-orders: - candidateCount - imageConfig - maxOutputTokens - responseModalities - temperature - thinkingConfig - topP x-apidog-orders: - candidateCount - imageConfig - maxOutputTokens - responseModalities - temperature - thinkingConfig - topP response_format: type: string description: >- Điền vào url và trả về url; nếu không, hãy điền base64 mặc định. safetySettings: type: array items: type: object required: - category - threshold properties: category: type: string enum: - HARM_CATEGORY_HARASSMENT - HARM_CATEGORY_HATE_SPEECH - HARM_CATEGORY_SEXUALLY_EXPLICIT - HARM_CATEGORY_DANGEROUS_CONTENT description: Danh mục bảo mật. threshold: type: string enum: - BLOCK_NONE - BLOCK_ONLY_HIGH - BLOCK_MEDIUM_AND_ABOVE - BLOCK_LOW_AND_ABOVE description: Ngưỡng chặn. x-apifox-orders: - category - threshold x-apidog-orders: - category - threshold description: >- Cài đặt bảo mật, không bắt buộc. Kiểm soát các ngưỡng lọc đối với nhiều loại nội dung có hại. systemInstruction: type: object required: - parts properties: parts: type: array items: type: object required: - text properties: text: type: string description: Văn bản lệnh hệ thống. x-apifox-orders: - text x-apidog-orders: - text description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. description: >- Lệnh hệ thống, không bắt buộc. Được dùng để giới hạn phong cách, ngôn ngữ, định dạng đầu ra, v.v. Khi tạo hình ảnh, bắt buộc phải "chỉ xuất các mô tả liên quan đến hình ảnh" hoặc giới hạn nội dung đầu ra trong các tình huống dịch thuật. x-apifox-orders: - parts x-apidog-orders: - parts refName: PostV1betaModelsGemini31FlashLiteImageGenerateContentRequest description: >- Phần thân yêu cầu tạo ảnh phía nguồn của Gemini 3.1 Flash-Lite Image (gemini-3.1-flash-lite-image / Nano Banana 2 Lite). Hỗ trợ chuyển văn bản thành ảnh, chuyển ảnh thành ảnh, chuyển video thành ảnh và chỉnh sửa ảnh trong một hoặc nhiều lượt. Mô hình này chỉ hỗ trợ đầu ra 1K và không hỗ trợ Google Search Grounding, Function Calling hay Live API. x-apifox-orders: - contents - generationConfig - response_format - safetySettings - systemInstruction x-apidog-orders: - contents - generationConfig - response_format - safetySettings - systemInstruction examples: '1': value: contents: - parts: - text: >- Một chú mèo dễ thương đang ngồi trên một chiếc bàn gỗ, theo phong cách màu nước. role: user generationConfig: imageConfig: aspectRatio: '1:1' responseModalities: - HÌNH ẢNH response_format: url summary: '1' description: Được đề xuất cho người mới bắt đầu · Hình ảnh Vincentian · 1:1 '2': value: contents: - parts: - text: >- Một áp phích tối giản cho quán cà phê, tông màu ấm, khoảng trống phía trên dành cho kiểu chữ gọn gàng. role: user generationConfig: imageConfig: aspectRatio: '9:16' responseModalities: - HÌNH ẢNH summary: '2' description: >- Khuyến nghị cho người mới · Hình ảnh Vincentian · Màn hình dọc 9:16 '3': value: contents: - parts: - text: >- Logo thể thao chuyên nghiệp cho một đội bóng rổ hư cấu ở Seattle có tên là Seattle Sasquatch. Phong cách nhận diện thể thao hiện đại, đường viền đậm và gọn gàng. Bảng màu: xanh rêu, nâu tuyết tùng và màu đồng. Phong cách đồ họa vector, tách biệt trên nền đen đồng nhất. role: user generationConfig: imageConfig: aspectRatio: '3:2' outputMimeType: image/png responseModalities: - HÌNH ẢNH thinkingConfig: includeThoughts: false thinkingLevel: CAO summary: '3' description: Đề xuất nâng cao · Biểu đồ Vincentian · Suy luận + đầu ra PNG '4': value: contents: - parts: - inlineData: data: '{{test_image_base64}}' mimeType: image/png - text: >- Tạo một phiên bản theo phong cách vẽ nguệch ngoạc của bông hoa màu đỏ trong hình ảnh này. role: user generationConfig: responseModalities: - HÌNH ẢNH summary: '4' description: Khuyến nghị nâng cao · Chỉnh sửa hình ảnh trong một lượt '5': value: contents: - parts: - inlineData: data: '{{ref_image_1_base64}}' mimeType: image/jpeg - inlineData: data: '{{ref_image_2_base64}}' mimeType: image/png - text: >- Hình kết xuất nhân vật 3D cách điệu về một người phụ nữ vui vẻ và chú chó dễ thương của cô ấy. Màu sắc sống động, đôi mắt biểu cảm, nền màu trơn gọn gàng, bố cục ảnh đại diện cân giữa. role: user generationConfig: imageConfig: aspectRatio: '4:3' responseModalities: - HÌNH ẢNH summary: '5' description: >- Đề xuất nâng cao · Tổng hợp hình ảnh đa tham chiếu (≤3 hình ảnh) '6': value: contents: - parts: - inlineData: data: '{{test_video_base64}}' mimeType: video/mp4 - text: Tạo một tấm bưu thiếp về khung cảnh trong video này. role: user generationConfig: responseModalities: - HÌNH ẢNH summary: '6' description: Đề xuất nâng cao · Chuyển đổi video thành hình ảnh responses: '200': description: '' content: application/json: schema: type: object required: - candidates - usageMetadata - modelVersion - createTime - responseId properties: candidates: type: array items: type: object properties: content: type: object required: - role - parts properties: parts: type: array items: type: object properties: inlineData: type: object required: - mimeType - data properties: data: type: string description: >- Dữ liệu phương tiện được mã hóa Base64 (không có tiền tố URI data:) mimeType: type: string description: >- Loại MIME của phương tiện, ví dụ: image/png, image/jpeg description: >- Dữ liệu phương tiện nội tuyến (hình ảnh/âm thanh/v.v.) x-apifox-orders: - data - mimeType x-apidog-orders: - data - mimeType thoughtSignature: type: string description: Chữ ký suy luận (nếu được mô hình trả về) x-apifox-orders: - inlineData - thoughtSignature x-apidog-orders: - inlineData - thoughtSignature description: >- Danh sách các phần nội dung; có thể bao gồm văn bản, inline_data / inlineData, v.v. role: type: string description: >- Vai trò của thông điệp, ví dụ: mô hình, người dùng description: Vui lòng cung cấp đối tượng nội dung cần dịch. x-apifox-orders: - parts - role x-apidog-orders: - parts - role finishReason: type: string description: 'Ly do ket thuc, vi du: STOP, MAX_TOKENS, SAFETY' x-apifox-orders: - content - finishReason x-apidog-orders: - content - finishReason description: Các câu trả lời ứng viên của mô hình createTime: type: string description: Thời gian tạo phản hồi modelVersion: type: string description: Phiên bản mô hình thực tế được sử dụng responseId: type: string description: ID duy nhất cho phản hồi này usageMetadata: type: object required: - promptTokenCount - candidatesTokenCount - totalTokenCount - trafficType - promptTokensDetails - candidatesTokensDetails properties: candidatesTokenCount: type: integer description: >- Dịch tài liệu kỹ thuật này sang tiếng Việt. Giữ nguyên Markdown, mã, định danh, URL, đường dẫn, chỗ giữ chỗ, cấu trúc JSON và định dạng. Chỉ trả về văn bản đã dịch và không để lại bất kỳ chữ Hán nào. Số token được các câu trả lời ứng viên sử dụng candidatesTokensDetails: type: array items: type: object properties: modality: type: string description: 'Loại phương thức, ví dụ: TEXT, IMAGE, AUDIO' tokenCount: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - modality - tokenCount x-apidog-orders: - modality - tokenCount description: Phân tích chi tiết token ứng viên theo từng dạng thức promptTokenCount: type: integer description: Số token được lời nhắc sử dụng promptTokensDetails: type: array items: type: object properties: modality: type: string description: 'Loại phương thức, ví dụ: TEXT, IMAGE, AUDIO' tokenCount: type: integer description: >- Vui lòng cung cấp nội dung tài liệu kỹ thuật cần dịch. x-apifox-orders: - modality - tokenCount x-apidog-orders: - modality - tokenCount description: Phân tích token trong lời nhắc theo từng phương thức totalTokenCount: type: integer description: Tổng số token trafficType: type: string description: Loại lưu lượng (liên quan đến thanh toán/hạn mức) description: Siêu dữ liệu về mức sử dụng token x-apifox-orders: - candidatesTokenCount - candidatesTokensDetails - promptTokenCount - promptTokensDetails - totalTokenCount - trafficType x-apidog-orders: - candidatesTokenCount - candidatesTokensDetails - promptTokenCount - promptTokensDetails - totalTokenCount - trafficType refName: PostV1betaModelsGemini31FlashLiteImageGenerateContentResponse x-apifox-orders: - candidates - createTime - modelVersion - responseId - usageMetadata x-apidog-orders: - candidates - createTime - modelVersion - responseId - usageMetadata examples: example: summary: example value: candidates: - content: parts: - inlineData: data: chuỗi mimeType: chuỗi thoughtSignature: chuỗi role: chuỗi finishReason: chuỗi createTime: chuỗi modelVersion: chuỗi responseId: chuỗi usageMetadata: candidatesTokenCount: 0 candidatesTokensDetails: - modality: chuỗi tokenCount: 0 promptTokenCount: 0 promptTokensDetails: - modality: chuỗi tokenCount: 0 totalTokenCount: 0 trafficType: chuỗi headers: {} x-apidog-name: '' '400': description: Yêu cầu không hợp lệ hoặc xác thực thất bại content: application/json: schema: type: object required: - error properties: error: type: object required: - message - type properties: message: type: string description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu) type: type: string description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error examples: - new_api_error x-apifox-orders: - message - type x-apidog-orders: - message - type refName: NewApiError x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: >- Yêu cầu không hợp lệ (mã yêu cầu: 20260805120000123456789AbCdEfGh) type: new_api_error headers: {} x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại '401': description: Khóa API bị thiếu hoặc không hợp lệ content: application/json: schema: type: object required: - error properties: error: type: object required: - message - type properties: message: type: string description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu) type: type: string description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error examples: - new_api_error x-apifox-orders: - message - type x-apidog-orders: - message - type refName: NewApiError x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: >- Mã thông báo không hợp lệ (request id: 20260805120000123456789AbCdEfGh) type: new_api_error headers: {} x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Trò chuyện/Gemini/Định dạng gốc x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208846-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```