Sinh hình ảnh (với Chat Completions)

POST /chat/completions

Tạo hình ảnh trong một cuộc hội thoại bằng cách sử dụng mô hình đa phương thức.

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

messagesarrayRequired

Một danh sách các đối tượng message. Message cuối cùng nên chứa prompt để tạo ảnh.

modelstringRequired

ID của mô hình đa phương thức sẽ sử dụng. Ví dụ: nano-banana-2 (= gemini-3.1-flash-image). Danh sách model xem ở Sinh hình ảnh.

modalitiesarray

Chỉ định ["image"] để yêu cầu trả về dữ liệu hình ảnh.

---

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

Phản hồi sẽ tương tự như của Chat Completions, nhưng đối tượng message sẽ chứa một mảng images.

Đối tượng ImageMessage

imagesarray

Một danh sách các đối tượng hình ảnh được tạo.

Đối tượng ImageURL

image_urlobject

Đối tượng chứa URL dữ liệu base64 của ảnh.

urlstring

URL dữ liệu base64 của ảnh (ví dụ: data:image/png;base64,...).

curlPython (openai)

curl https://api.thucchien.ai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer " \
-d '{
  "model": "nano-banana-2nano-banana-2-litenano-banana-progemini-3.1-flash-imagegemini-3.1-flash-lite-imagegemini-3-pro-imagegemini-2.5-flash-image",
  "messages": [
    {
      "role": "user",
      "content": "A breathtaking scene where a majestic waterfall cascades down rugged cliffs, shimmering like silver threads under the warm sunlight. Lush greenery surrounds the falls—towering trees, vibrant flowers, and soft moss painting nature’s perfect canvas. Mist rises gently, forming a magical rainbow that arches across the sky, while birds soar gracefully above as if dancing to the music of nature. A dreamlike moment that blends serenity and beauty in one stunning view."
    }
  ],
  "modalities": ["image"]
}'

Example Response

{
  "id": "chatcmpl-mock",
  "object": "chat.completion",
  "created": 1759806089,
  "model": "nano-banana-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": null,
        "images": [
          {
            "image_url": {
              "url": "data:image/png;base64,<base64_encoded_image_data>"
            }
          }
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 1,
    "total_tokens": 16
  }
}