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 đích | Phương thức | Điểm cuối |
|---|---|---|
| Tạo ảnh từ văn bản | POST | /v1/images/generations |
| Chỉnh sửa hình ảnh | POST | /v1/images/edits |
Mô hình và khả năng
| Mô hình | Độ phân giải | Ảnh tham chiếu | Số ảnh mỗi yêu cầu | Tính phí |
|---|---|---|---|---|
gpt-image-2 | 1K (mặc định) / 2K / 4Ksize theo pixel | tối đa 4 (tệp cục bộ) | luôn 1 | theo ảnh |
gpt-image-2.5-flare | 1K (mặc định) / 2K / 4Ksize theo pixel | tối đa 10 (tệp cục bộ) | luôn 1 | theo ảnh |
gpt-image-2.5-sunburst | 1K (mặc định) / 2K / 4Ksize theo pixel | tối đa 10 (tệp cục bộ) | luôn 1 | theo ảnh |
az-gpt-image-2 | 1K (mặc định) / 2K / 4Ksize theo pixel | tối đa 10 (tệp cục bộ / data URI / URL công khai) | tối đa 10 | theo token |
az-gpt-image-2.5-flare | 1K (mặc định) / 2K / 4Ksize theo pixel | tối đa 10 (tệp cục bộ / data URI / URL công khai) | tối đa 10 | theo token |
az-gpt-image-2.5-sunburst | 1K (mặc định) / 2K / 4Ksize theo pixel | tối đa 10 (tệp cục bộ / data URI / URL công khai) | tối đa 10 | theo 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ình | quality | background | output_format | response_format |
|---|---|---|---|---|
gpt-image-2 | low / medium / high | Không hỗ trợ | Không hỗ trợ | b64_json / url |
gpt-image-2.5-flare | low / medium / high | Không hỗ trợ | Không hỗ trợ | b64_json / url |
gpt-image-2.5-sunburst | low / medium / high | Không hỗ trợ | Không hỗ trợ | b64_json / url |
az-gpt-image-2 | low / medium / high / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-flare | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-sunburst | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_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ốtbackground, định dạng đầu raoutput_format, nhiều ảnh trong một yêu cầun(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/jsonKí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ệ | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 2400x1600 | 3504x2336 |
| 2:3 | 1024x1536 | 1600x2400 | 2336x3504 |
| 4:3 | 1152x864 | 2048x1536 | 3264x2448 |
| 3:4 | 864x1152 | 1536x2048 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1344x576 | 3024x1296 | 3840x1648 |
| 2:1 | 1408x704 | 2880x1440 | 3840x1920 |
| 1:2 | 704x1408 | 1440x2880 | 1920x3840 |
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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
model | string | Có | Tên mô hình hình ảnh, ví dụ gpt-image-2. |
prompt | string | Có | 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. |
size | string | Không | Kích thước theo pixel, quy tắc xem mục «Kích thước» ở trên. |
quality | string | Không | gpt-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. |
n | integer | Không | Số 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_format | string | Không | b64_json (mặc định) hoặc url. Khi chọn url sẽ trả về liên kết ảnh của 88API. |
background | string | Không | Chỉ az-gpt-image-*: transparent, opaque, auto. |
output_format | string | Không | Chỉ az-gpt-image-*: png (mặc định), webp, jpeg. |
output_compression | integer | Không | Chỉ 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"
}'jpegkhông hỗ trợ trong suốt, khi dùng cùngtransparentsẽ trả về ảnh không trong suốt.- Khi chỉnh sửa, truyền
transparentcó 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. opaquekhô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ơnaz-gpt-image-2(highcủa 2.5 xấp xỉmediumcủ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/responseshoặ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
maxcủaaz-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 trasizetheo 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ặcimage_model_wrong_endpoint, nghĩa là yêu cầu đã được gửi tới sai giao diện.
Tìm kiếm web DeepSeek
Cho DeepSeek V4.1 Flash tìm kiếm thông tin thời gian thực trên web và dẫn nguồn, bằng công cụ web_search của Responses API.
API mô hình hình ảnh Gemini
Định dạng yêu cầu theo giao thức tương thích OpenAI và giao thức gốc Gemini, tỷ lệ khung hình, độ phân giải và ảnh tham chiếu cho Gemini 3.1 Flash Image, Nano Banana 2.1 và Gemini 3 Pro Image.