gemini-3-pro-image API

Sử dụng ID mẫu chính xác gemini-3-pro-image. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫugemini-3-pro-imagePOST /v1beta/models/gemini-3-pro-image:generateContent

Thông số: size=2Kratio=16:9

Câu lệnh: Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text.

Yêu cầu tạo ra mẫu này

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev. Điểm vào cổng là POST /v1/models/{model}:generateContent.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo hình ảnh

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "A white cat runs through a neon-lit street in the rain"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

Ghi chú yêu cầu

Mô hình hình ảnh Gemini sử dụng contents và generationConfig gốc; chỉnh sửa gửi hướng dẫn văn bản và inline_data trong cùng parts[].

Tham số yêu cầu

Mô hình hình ảnh Gemini sử dụng Gemini bản địa generateContent. Đặt văn bản và hình ảnh tham chiếu trong cùng một contents[].parts[]; hình ảnh sử dụng inline_data. Không gửi các mô hình này tới /v1/images/generations, /v1/images/edits hoặc OpenAI /v1/responses. Enum imageSize dành riêng cho từng mô hình và được hiển thị bên dưới.

Cánh đồng	Bắt buộc	Ghi chú
contents[].parts[].text	Có	Lời nhắc văn bản hoặc hướng dẫn chỉnh sửa
contents[].parts[].inline_data	Không	Dữ liệu hình ảnh Base64 và loại MIME
contents[].parts[].inline_data.mime_type	Không	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	Không	Nội dung hình ảnh tham chiếu được mã hóa Base64
generationConfig.responseModalities	Có	["IMAGE"] hoặc ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	Không	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	Không	1K / 2K / 4K

Giới hạn phản hồi và đầu vào

Pro hỗ trợ 1K, 2K và 4K với 1:1, 4:3, 3:4, 16:9 và 9:16. Tài liệu chính thức không công bố giới hạn số lượng hình ảnh tham chiếu, do đó cổng không thêm giới hạn cục bộ.

Ví dụ chỉnh sửa ảnh

Đặt hướng dẫn chỉnh sửa và hình ảnh tham chiếu vào cùng một contents[].parts[]. inline_data.data là nội dung hình ảnh Base64; không gửi các mẫu hình ảnh Gemini tới các điểm cuối Hình ảnh OpenAI hoặc Responses.

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "Keep the subject and lighting, but replace the background with a misty pine forest."},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

Hình dạng phản hồi

Đọc candidates[].content.parts[]; đừng cho rằng mọi phần đều là hình ảnh vì phản hồi có thể chứa các phần văn bản và hình ảnh cùng nhau.

Cánh đồng	Ghi chú
candidates[].content.parts[].inline_data	Đã tạo loại MIME hình ảnh và dữ liệu Base64
candidates[].content.parts[].text	Chú thích văn bản được trả về khi TEXT được yêu cầu
candidates[].finishReason	Lý do hoàn thành hoặc an toàn
usageMetadata	Việc sử dụng mã thông báo đầu vào/đầu ra khi được dịch vụ trả về

Modelflare duy trì hình dạng phản hồi gốc của Gemini cho gemini-3-pro-image và duy trì các phần hình ảnh có thể sử dụng được.

Lỗi và tác vụ không thành công

Lỗi trường, giới hạn kích thước/tỷ lệ và từ chối an toàn từ yêu cầu Gemini gốc vẫn là phản hồi lỗi tương thích với Gemini. Cổng không viết lại chúng dưới dạng phản hồi Hình ảnh OpenAI.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng thanh toán dựa trên mã thông báo. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.