Tạo ảnh với Gemini

POST

v1beta

models

{model}

:generateContent

import os
from google import genai
from google.genai import types

client = genai.Client(
    http_options={"api_version": "v1beta", "base_url": "https://api.cometapi.com"},
    api_key=os.environ.get("COMETAPI_KEY"),
)

response = client.models.generate_content(
    model="gemini-3.1-flash-lite-image",
    contents="A Monarch butterfly anatomical sketch on textured parchment",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="1:1", image_size="1K"),
    ),
)

final_image = None
for part in response.parts:
    if getattr(part, "thought", False):
        continue
    if part.text:
        print(part.text)
    elif image := part.as_image():
        final_image = image

if final_image:
    final_image.save("output.png")

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ]
      },
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123
  }
}

Để xem các ví dụ từng bước, hãy tham khảo Use Gemini image models.

Các tùy chọn tạo ảnh của Gemini có thể thay đổi khi Google cập nhật các model ảnh và generateContent. Hãy kiểm tra tài liệu tạo ảnh Gemini để xem danh sách tham số đầy đủ mới nhất và hành vi riêng theo từng nhà cung cấp.

gemini-2.5-flash-image được nhà cung cấp lên lịch ngừng hoạt động vào ngày 2026-10-02. Với các dự án mới, hãy sử dụng gemini-3.1-flash-image-preview hoặc gemini-3-pro-image-preview. Xem lịch ngừng hỗ trợ của Google để biết chi tiết.

Phản hồi ảnh của Gemini có thể bao gồm các phần ảnh trung gian trong đó thought là true. Đây không phải là đầu ra cuối cùng. Khi lưu ảnh được tạo, hãy bỏ qua các phần thought: true và sử dụng phần ảnh cuối cùng có inlineData tồn tại và thought không phải là true.

Ủy quyền

Authorization

string

header

bắt buộc

Use your CometAPI API key.

Tham số đường dẫn

model

string

mặc định:gemini-3.1-flash-image-preview

bắt buộc

The Gemini image model to use. See the Models page for current options.

Nội dung

application/json

contents

object[]

bắt buộc

Conversation turns. Each item has a role ("user" or "model") and parts array containing text and/or image data.

Show child attributes

generationConfig

object

Controls generation behavior — output modalities, image resolution, thinking, etc.

Show child attributes

tools

object[]

Optional tools. Pass [{"google_search": {}}] to enable Google Search grounding for real-time information in generated images.

Show child attributes

Phản hồi

200 - application/json

Success

candidates

object[]

Show child attributes

usageMetadata

object

Show child attributes

Tạo chỉnh sửa hình ảnh

Sử dụng các model hình ảnh Gemini

import os
from google import genai
from google.genai import types

client = genai.Client(
    http_options={"api_version": "v1beta", "base_url": "https://api.cometapi.com"},
    api_key=os.environ.get("COMETAPI_KEY"),
)

response = client.models.generate_content(
    model="gemini-3.1-flash-lite-image",
    contents="A Monarch butterfly anatomical sketch on textured parchment",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="1:1", image_size="1K"),
    ),
)

final_image = None
for part in response.parts:
    if getattr(part, "thought", False):
        continue
    if part.text:
        print(part.text)
    elif image := part.as_image():
        final_image = image

if final_image:
    final_image.save("output.png")

{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "mimeType": "<string>",
              "data": "<string>"
            },
            "thought": true,
            "thoughtSignature": "<string>"
          }
        ]
      },
      "index": 123,
      "safetyRatings": [
        {
          "category": "<string>",
          "probability": "<string>"
        }
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123
  }
}

Kiểm duyệt nội dung

Khóa API

Ủy quyền

Tham số đường dẫn

Nội dung

Phản hồi