Sinh/Sửa hình ảnh (với Google Gemini)

POST /gemini/v1beta/models/gemini-2.5-flash-image-preview:generateContent

Tạo hình ảnh, sửa hình ảnh với endpoint pass through tới Google Gemini.

Tham khảo

Chi tiết đầy đủ các tham số, tham khảo tài liệu Google Gemini.

Cấu trúc yêu cầu (Request Body)

contentsarrayRequired

Nội dung của yêu cầu.

partsarrayRequired

Một danh sách các phần của nội dung. Phần tử đầu tiên nên là prompt văn bản.

textstringRequired

Prompt văn bản để tạo hình ảnh.

inline_datastring

Dữ liệu hình ảnh dưới dạng base64 (nếu có). Tham khảo cách truyền dữ liệu hình ảnh tại đây.

mime_typestring

Loại MIME của hình ảnh, ví dụ: image/png, image/jpeg.

datastring

Dữ liệu hình ảnh dưới dạng base64.

generationConfigobject

Cấu hình cho việc sinh nội dung.

imageConfigobject

Cấu hình dành riêng cho việc sinh hình ảnh.

aspectRatiostring

Tỷ lệ khung hình của hình ảnh được tạo. Các giá trị được hỗ trợ:

• Landscape: 21:9, 16:9, 4:3, 3:2
• Square: 1:1
• Portrait: 9:16, 3:4, 2:3
• Flexible: 5:4, 4:5

---

Cấu trúc Phản hồi (Response Body)

Đối tượng Candidate

candidatesarray

Một danh sách các ứng viên được tạo.

contentobject

Nội dung của ứng viên.

partsarray

Một danh sách các phần của nội dung.

inlineDataobject

Dữ liệu hình ảnh dưới dạng base64.

mimeTypestring

Loại MIME của hình ảnh, ví dụ: image/png.

datastring

Dữ liệu hình ảnh được mã hóa base64.

curl

curl 'https://api.thucchien.ai/gemini/v1beta/models/gemini-2.5-flash-image-preview:generateContent' \
-H 'x-goog-api-key: ' \
-H 'Content-Type: application/json' \
-d '{
  "contents": [{
    "parts": [
      {"text": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep, sun-etched wrinkles and a warm, knowing smile. He is carefully inspecting a freshly glazed tea bowl. The setting is his rustic, sun-drenched workshop with pottery wheels and shelves of clay pots in the background. The scene is illuminated by soft, golden hour light streaming through a window, highlighting the fine texture of the clay and the fabric of his apron. Captured with an 85mm portrait lens, resulting in a soft, blurred background (bokeh). The overall mood is serene and masterful."}
    ]
  }],
  "generationConfig": {
      "imageConfig": {
          "aspectRatio": "21:916:94:33:21:19:163:42:35:44:5"
      }
  }
}'

Example Response

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<base64_encoded_image_data>"
            }
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
          "probability": "NEGLIGIBLE"
        },
        {
          "category": "HARM_CATEGORY_HATE_SPEECH",
          "probability": "NEGLIGIBLE"
        },
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE"
        },
        {
          "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
          "probability": "NEGLIGIBLE"
        }
      ]
    }
  ]
}