88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
Image

API mô hình hình ảnh OpenAI

Giao diện, kích thước, mức chất lượng, ảnh tham chiếu và nền trong suốt của các mô hình hình ảnh gpt-image-2, gpt-image-2.5 và dòng az-gpt-image.

Phạm vi áp dụng

Trang này giới thiệu giao diện hình ảnh của các mô hình hình ảnh OpenAI (gpt-image-* và az-gpt-image-*). Với mô hình hình ảnh Gemini, xem API mô hình hình ảnh Gemini; với mô hình hình ảnh Grok, xem API mô hình hình ảnh Grok.

Tài liệu chính thức

Chọn giao diện

Các mô hình hình ảnh OpenAI chỉ dùng giao diện hình ảnh, không dùng /v1/chat/completions hoặc /v1/responses để thay thế:

Mục đíchPhương thứcĐiểm cuối
Tạo ảnh từ văn bảnPOST/v1/images/generations
Chỉnh sửa hình ảnhPOST/v1/images/edits

Mô hình và khả năng

Mô hìnhĐộ phân giảiẢnh tham chiếuSố ảnh mỗi yêu cầuTính phí
gpt-image-21K (mặc định) / 2K / 4K
size theo pixel
tối đa 4 (tệp cục bộ)luôn 1theo ảnh
gpt-image-2.5-flare1K (mặc định) / 2K / 4K
size theo pixel
tối đa 10 (tệp cục bộ)luôn 1theo ảnh
gpt-image-2.5-sunburst1K (mặc định) / 2K / 4K
size theo pixel
tối đa 10 (tệp cục bộ)luôn 1theo ảnh
az-gpt-image-21K (mặc định) / 2K / 4K
size theo pixel
tối đa 10 (tệp cục bộ / data URI / URL công khai)tối đa 10theo token
az-gpt-image-2.5-flare1K (mặc định) / 2K / 4K
size theo pixel
tối đa 10 (tệp cục bộ / data URI / URL công khai)tối đa 10theo token
az-gpt-image-2.5-sunburst1K (mặc định) / 2K / 4K
size theo pixel
tối đa 10 (tệp cục bộ / data URI / URL công khai)tối đa 10theo token

Tỷ lệ khung hình hỗ trợ: 1:1 (mặc định) / 3:2 / 2:3 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9 / 2:1 / 1:2

Mô hìnhqualitybackgroundoutput_formatresponse_format
gpt-image-2low / medium / highKhông hỗ trợKhông hỗ trợb64_json / url
gpt-image-2.5-flarelow / medium / highKhông hỗ trợKhông hỗ trợb64_json / url
gpt-image-2.5-sunburstlow / medium / highKhông hỗ trợKhông hỗ trợb64_json / url
az-gpt-image-2low / medium / high / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-flarelow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-sunburstlow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url

Hai nhóm mô hình được gọi theo cùng một cách, khác nhau ở tham số khả dụng và cách tính phí:

  • gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst: tính phí theo ảnh, giá không phụ thuộc kích thước hay mức chất lượng. Hỗ trợ size, quality, mỗi yêu cầu trả về 1 ảnh.
  • az-gpt-image-2, az-gpt-image-2.5-flare, az-gpt-image-2.5-sunburst: hỗ trợ đầy đủ tham số OpenAI Images, gồm nền trong suốt background, định dạng đầu ra output_format, nhiều ảnh trong một yêu cầu n (tối đa 10), xem trước dạng luồng và yêu cầu chỉnh sửa dạng JSON. Tính phí theo token, chi phí thay đổi theo kích thước và mức chất lượng.

Mô hình thực tế có thể dùng được căn cứ theo danh sách mô hình hiển thị trong bảng điều khiển.

Xác thực

Mọi yêu cầu đều cần mang theo token truy cập 88API:

Authorization: Bearer $API_KEY
Content-Type: application/json

Kích thước

size phải ghi theo pixel dạng rộngxcao, không chấp nhận chuỗi như 1K, 2K, 4K. Kích thước hợp lệ phải đồng thời thỏa mãn:

  • Chiều rộng và chiều cao đều là bội số của 16;
  • Cạnh dài nhất không vượt quá 3840;
  • Tỷ lệ cạnh dài so với cạnh ngắn không vượt quá 3:1;
  • Tổng số pixel nằm trong khoảng 655.360 (khoảng 816×816) đến 8.294.400 (3840×2160).

Bảng dưới đây là các kích thước khuyến nghị cho từng mức, dùng chung cho mọi mô hình:

Tỷ lệ1K2K4K
1:11024x10242048x20482880x2880
3:21536x10242400x16003504x2336
2:31024x15361600x24002336x3504
4:31152x8642048x15363264x2448
3:4864x11521536x20482448x3264
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
21:91344x5763024x12963840x1648
2:11408x7042880x14403840x1920
1:2704x14081440x28801920x3840

Khi không truyền size hoặc truyền auto, mô hình sẽ tự quyết định kích thước. Kích thước không đúng các quy tắc trên có thể bị từ chối hoặc bị tự động điều chỉnh, vì vậy hãy tự kiểm tra trước khi gửi yêu cầu.

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

Yêu cầu

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Một chú mèo cam ngồi bên cửa sổ, ánh sáng tự nhiên buổi chiều, phong cách nhiếp ảnh chân thực",
    "size": "2048x2048",
    "quality": "medium"
  }'

Tham số yêu cầu

Tham sốKiểuBắt buộcMô tả
modelstringCóTên mô hình hình ảnh, ví dụ gpt-image-2.
promptstringCóMô tả nội dung hình ảnh. Nên ghi rõ chủ thể, bố cục, phong cách, ánh sáng và khung hình.
sizestringKhôngKích thước theo pixel, quy tắc xem mục «Kích thước» ở trên.
qualitystringKhônggpt-image-* hỗ trợ low, medium, high. az-gpt-image-2 hỗ trợ low, medium, high, auto; az-gpt-image-2.5-* hỗ trợ thêm xhigh, max. Khi không truyền sẽ tạo theo mức low.
nintegerKhôngSố lượng ảnh. az-gpt-image-* hỗ trợ từ 1 đến 10; gpt-image-* mỗi yêu cầu trả về 1 ảnh, cần nhiều ảnh thì gửi nhiều yêu cầu.
response_formatstringKhôngb64_json (mặc định) hoặc url. Khi chọn url sẽ trả về liên kết ảnh của 88API.
backgroundstringKhôngChỉ az-gpt-image-*: transparent, opaque, auto.
output_formatstringKhôngChỉ az-gpt-image-*: png (mặc định), webp, jpeg.
output_compressionintegerKhôngChỉ az-gpt-image-*, từ 0 đến 100, chỉ có hiệu lực với jpeg, webp.

Ví dụ phản hồi

{
  "created": 1760000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ]
}

Mặc định trả về data[].b64_json; nếu yêu cầu chỉ định "response_format": "url" thì trả về data[].url.

Chỉnh sửa hình ảnh

Chỉnh sửa hình ảnh dùng /v1/images/edits. Khi tải lên ảnh cục bộ, hãy dùng multipart/form-data; với nhiều ảnh tham chiếu thì lặp lại trường image[]. Tối đa 10 ảnh (gpt-image-2 tối đa 4 ảnh), hỗ trợ PNG, JPEG, WebP.

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@person.png" \
  -F "image[]=@product.png" \
  -F "prompt=Cho người trong ảnh thứ nhất cầm sản phẩm trong ảnh thứ hai, giữ nguyên ngoại hình của người và sản phẩm" \
  -F "size=1536x1024"

Ảnh tham chiếu được đánh số theo thứ tự tải lên, trong prompt có thể gọi là «ảnh thứ nhất», «ảnh thứ hai».

Yêu cầu chỉnh sửa dạng JSON (chỉ az-gpt-image-*)

az-gpt-image-* còn hỗ trợ yêu cầu chỉnh sửa dạng JSON, ảnh tham chiếu có thể là Data URI hoặc URL công khai:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "az-gpt-image-2.5-flare",
    "prompt": "Thay nền thành phòng chụp màu xanh nhạt",
    "images": [
      { "image_url": "data:image/png;base64,..." },
      { "image_url": "https://example.com/reference.png" }
    ],
    "size": "1024x1024"
  }'

Với gpt-image-*, hãy dùng tải lên multipart.

Nền trong suốt (chỉ az-gpt-image-*)

Khi cần sticker, biểu tượng hoặc ảnh tách nền có nền trong suốt, đặt background là transparent và dùng đầu ra png hoặc webp:

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "az-gpt-image-2",
    "prompt": "Sticker một chú gấu trúc giơ tấm biển «Cố lên», đường viền gọn gàng",
    "size": "1024x1024",
    "background": "transparent",
    "output_format": "png"
  }'
  • jpeg không hỗ trợ trong suốt, khi dùng cùng transparent sẽ trả về ảnh không trong suốt.
  • Khi chỉnh sửa, truyền transparent có thể xóa nền; nếu bản thân ảnh tham chiếu đã trong suốt thì đầu ra cũng sẽ giữ trong suốt.
  • opaque không đảm bảo hoàn toàn không trong suốt: khi prompt yêu cầu rõ «sticker», «không nền», vẫn có thể trả về ảnh trong suốt.

Xem trước dạng luồng (chỉ az-gpt-image-*)

Đặt "stream": true và "partial_images" từ 1 đến 3, giao diện sẽ trả về qua SSE các bản xem trước trung gian image_generation.partial_image, sự kiện cuối cùng image_generation.completed chứa ảnh hoàn chỉnh và lượng sử dụng; với yêu cầu chỉnh sửa, tên sự kiện là image_edit.*.

Tính phí

  • gpt-image-* tính phí theo số ảnh trả về thành công, không phụ thuộc kích thước hay mức chất lượng.
  • az-gpt-image-* tính phí theo token: đầu vào văn bản, đầu vào hình ảnh (ảnh tham chiếu) và đầu ra hình ảnh được tính giá riêng. Token đầu ra chỉ phụ thuộc vào kích thước và mức chất lượng, mức càng cao thì phí càng cao; ở cùng tên mức, az-gpt-image-2.5-* dùng ít token hơn az-gpt-image-2 (high của 2.5 xấp xỉ medium của 2).
  • Yêu cầu thất bại không bị tính phí.

Giới hạn quan trọng

  • Không gửi yêu cầu của các mô hình này tới /v1/responses hoặc /v1/chat/completions.
  • Không hỗ trợ vẽ lại cục bộ bằng mask: mặt nạ được truyền vào sẽ không được dùng để vẽ lại theo vùng; khi cần sửa một phần, hãy mô tả vị trí trong prompt.
  • Không hỗ trợ tham số input_fidelity.
  • Không nên dùng GIF làm ảnh tham chiếu, hãy chuyển sang PNG trước.
  • Mức chất lượng cao và kích thước 4K có thể mất 1 đến 2 phút, mức max của az-gpt-image-2.5-* có thể mất tới khoảng 2 phút rưỡi; nên đặt thời gian chờ của client từ 5 phút trở lên.
  • Nếu nhận được Invalid size ..., hãy kiểm tra size theo quy tắc ở mục «Kích thước» phía trên.
  • Nếu nhận được This model does not support image generation. hoặc image_model_wrong_endpoint, nghĩa là yêu cầu đã được gửi tới sai giao diện.