Khác biệt về tham số và API của GPT-Image

Tìm hiểu khác biệt về tham số và cách dùng dòng GPT-Image với API tạo và chỉnh sửa ảnh.

Điều chỉnh tham số tạo, chỉnh sửa và đầu ra theo model đã chọn. Xem Tạo ảnh và Chỉnh sửa ảnh để biết cấu trúc đầy đủ của yêu cầu và phản hồi.

Model áp dụng

Model	API hỗ trợ
gpt-image-2.6-sunburstMới gpt-image-2.6-flareMới gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5	OpenAI Images: Tạo ảnh, Chỉnh sửa ảnh

Khác biệt về tham số tạo ảnh

Trường	Khác biệt
`quality`	2.6 và 2.5 hỗ trợ `auto/low/medium/high/xhigh/max`; 2 và 1.5 hỗ trợ `auto/low/medium/high`. Tất cả mặc định là `auto`
`size`	1.5 hỗ trợ `auto`, `1024x1024`, `1024x1536`, `1536x1024`; 2 và 2.5 hỗ trợ kích thước tùy chỉnh, mỗi cạnh là bội số của 16 và không vượt quá 3840, tỷ lệ khung hình 1:3–3:1, tổng số pixel 655360–8294400. Kích thước trên 3686400 pixel mang tính thử nghiệm
`size` (2.6)	Hỗ trợ `auto` hoặc kích thước tùy chỉnh, chiều rộng và chiều cao là bội số của 16, tỷ lệ 1:3–3:1. GIF còn bị giới hạn bởi số khung hình và tổng ngân sách pixel; không dùng nguyên cấu hình kích thước ảnh tĩnh
`complexity`	2.6 hỗ trợ `low/medium/high`, mặc định `high`. Điều khiển mức lập kế hoạch trước khi tạo; `quality` điều khiển chi tiết kết xuất. Hai tham số được đặt độc lập
`background`	Để có nền trong suốt, đặt rõ `transparent` và dùng `png` hoặc `webp` cho ảnh raster. JPEG không giữ kênh alpha. Nền trong suốt trên 2 là tính năng xem trước chính thức

Khác biệt về tham số chỉnh sửa

Trường	Khác biệt
`input_fidelity`	1.5 hỗ trợ `low/high`, mặc định `low`; chọn `high` để giữ chi tiết đầu vào. 2 luôn xử lý với độ trung thực cao nên bỏ trường này. Với 2.6 cũng bỏ trường này; không áp dụng nguyên cấu hình 1.5 cho model mới
`markup`	2.5 và 2.6 hỗ trợ chỉnh sửa theo chú thích. Cung cấp lớp phủ PNG có vùng trong suốt, cùng kích thước với ảnh đầu vào đầu tiên sau khi chỉnh hướng, và mô tả thay đổi trong prompt
`mask`, `markup`	Chọn một trong hai; khi có nhiều ảnh đầu vào, áp dụng cho ảnh đầu tiên. Mask dùng vùng trong suốt để xác định vùng chỉnh sửa; lớp chú thích dùng vòng tròn, mũi tên hoặc dấu chỉ dẫn khác
`output_format`	Dùng `png/jpeg/webp` cho kết quả chỉnh sửa; dùng API tạo ảnh cho đầu ra SVG hoặc GIF

Khác biệt về định dạng đầu ra

Trường	Khác biệt
`output_format`	Cả sáu model hỗ trợ `png/jpeg/webp`, mặc định `png`; tạo ảnh với 2.6 còn hỗ trợ `svg/gif`
`output_compression`	Chỉ dùng cho `jpeg/webp`, phạm vi `0～100`; bỏ khi dùng PNG, SVG hoặc GIF
SVG	Khi tạo ảnh với 2.6, đặt `output_format: "svg"` và `n: 1`; không dùng streaming hoặc ảnh trung gian. Giải mã `data[0].b64_json` rồi lưu thành `.svg`; nội dung là XML UTF-8
`svg`	Chọn model biên soạn SVG, khác với `model` ảnh ở cấp cao nhất. Chỉ điền `svg.model` khi tính năng chọn model SVG được bật; nếu không, bỏ toàn bộ đối tượng. `svg.reasoning` và `complexity` của ảnh được điều khiển riêng
GIF	Khi tạo ảnh với 2.6, đặt `output_format: "gif"`; không dùng streaming, ảnh trung gian hoặc nén tùy chỉnh. Giải mã `data[].b64_json` rồi lưu thành `.gif`
`frame_count`	Chỉ dùng cho GIF, `2～16` khung hình, mặc định `9`. Số khung hình, kích thước mỗi khung và `n` cùng chịu tổng ngân sách pixel; giảm một mục nếu vượt giới hạn
`frame_duration_ms`	Chỉ dùng cho GIF, `20～2000` mili giây, mặc định `200`, làm tròn theo 10 mili giây

Ví dụ yêu cầu

Thay MODEL_ID bằng ID model đầy đủ do nền tảng cung cấp. Các ví dụ tạo ảnh, SVG và GIF dưới đây dùng 2.6; chỉnh sửa theo chú thích dùng 2.5 hoặc 2.6.

curl 'https://api.agtcloud.ai/v1/images/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "Áp phích khai trương quán cà phê đơn giản, tiêu đề OPEN TODAY, bố cục chữ rõ ràng",
    "quality": "medium",
    "complexity": "high",
    "size": "1024x1024",
    "output_format": "png"
  }'