Tài liệu tham khảo API tạo/chỉnh sửa ảnh từ văn bản

Tài liệu tham khảo giao diện của dòng Nano Banana (mô hình ảnh trong hệ sinh thái Gemini). Giới thiệu dòng và mẹo viết prompt xem Nano Banana 生图。

Tạo ảnh từ văn bản

POST https://api.4allapi.com/v1/images/generations

curl https://api.4allapi.com/v1/images/generations \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-portrait",
    "prompt": "杂志封面质感的人像,自然光,浅景深,画面下方写着\"OMNI\""
  }'

Tỷ lệ khung hình và độ phân giải dùng hậu tố của model:-square / -portrait / -landscape / -three-four / -four-three, bản chất lượng cao thêm -2k;
Gemini có hiệu năng tốt trong kết xuất chữ trên ảnh, nội dung chữ nên đặt trong dấu ngoặc kép trong prompt.

Chỉnh sửa ảnh (lấy ảnh sửa ảnh)

POST https://api.4allapi.com/v1/images/edits

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gemini-3.1-flash-image" \
  -F image="@ref.png" \
  -F prompt="同一人物改为冬季雪景全身照,保持面部特征一致"

Nhiều ảnh tham chiếu thì truyền nhiều trường image theo thứ tự, prompt mô tả vai trò của từng ảnh (ảnh chủ thể/ảnh phong cách);
Trường hợp cần nhất quán nhân vật/sản phẩm nên ưu tiên dùng giao diện chỉnh sửa thay vì tạo ảnh từ văn bản lại.

Cấp độ model

Cấp độ	Model đại diện	Đặc điểm
Pro	`gemini-3.0-pro-image` series	Chất lượng cao nhất, chi tiết và chữ ổn định nhất
Tiêu chuẩn	`gemini-3.1-flash-image` series	Cân bằng chất lượng/tốc độ, là cấp chính
Xem trước	`gemini-3-pro-image`	Tính năng mới được xem trước

Model đang bán và đơn giá theo thời gian thực vui lòng xem tại 模型广场; cấu trúc phản hồi và lưu ý khi lưu chuyển giống với 文生图 API 参考。