Skip to main content

Sinh hình ảnh (Image Generation)

POST /images/generations​

Tạo một hoặc nhiều hình ảnh dựa trên mô tả văn bản (prompt).

Phương pháp thay thế

Ngoài endpoint này, bạn cũng có thể tạo ảnh bằng cách sử dụng các mô hình đa phương thức thông qua endpoint /chat/completions.

Tham khảo

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

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

promptstringRequired

Mô tả chi tiết về hình ảnh cần tạo.

modelstringRequired

Mô hình Nano Banana (Gemini Image) sẽ sử dụng để tạo ảnh. Tên alias và ID gốc gọi cùng một model:

  • nano-banana-2 = gemini-3.1-flash-image
  • nano-banana-2-lite = gemini-3.1-flash-lite-image: rẻ và nhanh nhất
  • nano-banana-pro = gemini-3-pro-image: chất lượng cao nhất
  • nano-banana = gemini-2.5-flash-image: Google ngừng hỗ trợ từ 02/10/2026
ninteger

Số lượng hình ảnh cần tạo. Chỉ hỗ trợ 1; cần nhiều ảnh thì gửi nhiều request.

aspect_ratiostring

Tỷ lệ khung hình của ảnh. Có thể là 1:1, 3:4, 4:3, 16:9, 9:16. Mặc định 1:1. Tham số size không có tác dụng, hãy dùng aspect_ratio.

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

API sẽ trả về một đối tượng JSON chứa danh sách các hình ảnh được tạo.

Đối tượng ImageResponse​

createdinteger

Thời gian Unix timestamp của thời điểm yêu cầu được tạo.

dataarray

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

b64_jsonstring

Dữ liệu hình ảnh được mã hóa dưới dạng Base64.

revised_promptstring

Prompt đã được tinh chỉnh bởi mô hình để tạo ra hình ảnh tốt hơn (nếu có).

curl https://api.thucchien.ai/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer " \
-d '{
  "model": "",
  "prompt": "",
  "aspect_ratio": ""
}'
Example Response
{
  "created": 1759806089,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zUAAAgAE... [TRUNCATED]",
      "revised_prompt": "A photorealistic image of an astronaut in a full s... [TRUNCATED] ...th is visible as a small blue dot in the distance."
    }
  ]
}