Tham số GPT Image 2 API: kích thước, độ phân giải, tỷ lệ khung hình và chất lượng
Các tham số GPT Image 2 API quyết định tấm ảnh: tên mô hình, kích thước và độ phân giải, tỷ lệ khung hình, giới hạn 4K, chất lượng, định dạng và lỗi trả về.
Đọc dạng MarkdownGPT Image 2 API nhận tên mô hình trong model, kích thước đầu ra trong size dưới dạng pixel WIDTHxHEIGHT, và chất lượng trong quality (low, medium, high hoặc auto). Không có trường resolution hay aspect_ratio. Để có ảnh 16:9 ở 4K, bạn gửi "size": "3840x2160". Kích thước phải là bội số của 16, cả hai cạnh không vượt quá 3840 pixel, tỷ lệ nằm trong khoảng 1:3 đến 3:1, và tổng số pixel nằm trong khoảng 655.360 đến 8.294.400.
Hướng dẫn này đi qua từng tham số làm thay đổi tấm ảnh, với giá trị chính xác cần gửi và lỗi mà một giá trị sai trả về. Mọi lỗi dưới đây đều đã được kiểm tra trên API đang chạy thật.
Tên mô hình GPT Image 2 trong API là gì?
Dùng gpt-image-2 hoặc gpt-image-2-official. Cả hai là cùng một mô hình với cùng các trường; gpt-image-2 tính một mức giá cố định cho mỗi ảnh được giao, còn gpt-image-2-official tính theo số token mà mỗi lần dựng ảnh báo về.
Tên lấy từ tiêu đề không dùng được làm ID mô hình. gpt-image-2.0, GPT Image 2 hay chatgpt-images-2 đều trả về HTTP 400 với mã lỗi 20002.
Đặt độ phân giải và tỷ lệ khung hình thế nào?
Bằng size, tính theo pixel. Chọn tỷ lệ khung hình và lượng pixel bạn muốn, rồi gửi chiều rộng và chiều cao tương ứng:
| Tỷ lệ khung hình | Khoảng 1K | Khoảng 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1456x624 | 3024x1296 | 3808x1632 |
| 3:1 | 1728x576 | 3504x1168 | 3840x1280 |
Đây chính là các phép quy đổi mà Playground dùng khi bạn chọn một tỷ lệ và một mức đặt sẵn 1K, 2K hoặc 4K. Ảnh vuông 4K dừng ở 2880x2880 vì một hình vuông 3840 pixel sẽ vượt giới hạn tổng số pixel.
size: "auto" để mô hình tự quyết định kích thước. Đây là giá trị mặc định và tiện lợi, nhưng hãy đặt kích thước tường minh khi đầu ra cần khớp với một bố cục hoặc khớp với nhau.
OpenAI mô tả đầu ra lớn hơn 2560×1440 là thử nghiệm. Nó được chấp nhận trong các giới hạn nêu ở đây, nhưng khung ảnh lớn hơn không đảm bảo có nhiều chi tiết hơn.
Những giá trị size nào bị từ chối?
| Giá trị gửi | Vì sao lỗi | Phản hồi |
|---|---|---|
"size": "16:9" | Tỷ lệ không phải kích thước | 400 20001, thông báo nêu size |
"size": "4096x2304" | Cạnh lớn hơn 3840 | 400 20001, thông báo nêu size |
"size": "1000x1000" | Không phải bội số của 16 | 400 20001, thông báo nêu size |
"size": "3840x1024" | Rộng hơn 3:1 | 400 20001, thông báo nêu size |
"resolution": "4k" | Trường không xác định | 400 20001, không nêu trường nào |
"aspect_ratio": "16:9" | Trường không xác định | 400 20001, không nêu trường nào |
Hãy chú ý hai dòng cuối. Một trường không xác định sẽ bị từ chối, nhưng lỗi không nêu tên trường đó. Nếu bạn nhận 20001 với thông báo chung “Check the parameters against the API documentation”, hãy tìm một trường mà API không chấp nhận, chẳng hạn resolution, aspect_ratio hay response_format.
Nên chọn chất lượng nào?
quality nhận low, medium, high và auto. Mức càng cao thì chạy càng lâu và giữ chi tiết càng mịn. xhigh và max chỉ thuộc về GPT Image 2.5; gửi chúng tới GPT Image 2 sẽ trả về 20001 với thông báo nêu tên quality.
Một quy trình thực tế: làm bản nháp ở low khi bố cục còn đang thay đổi, kiểm tra kết cấu và chữ nhỏ ở medium, rồi xuất bản cuối ở high. Với gpt-image-2, giá như nhau ở mọi mức. Với gpt-image-2-official, mức cao hơn báo về nhiều token đầu ra hơn, nên tốn nhiều hơn. Hướng dẫn giá có các con số cụ thể.
auto để mô hình tự chọn mức. Hãy đặt giá trị tường minh khi so sánh các lần chạy, nếu không hai yêu cầu "giống hệt nhau" có thể được dựng ở các mức khác nhau.
Điều gì kiểm soát định dạng và nền?
output_format:png(mặc định) hoặcjpeg. Không hỗ trợ đầu ra WebP;webptrả về20001với thông báo nêu tênoutput_format.output_compression: từ 0 đến 100, chỉ dùng vớijpeg.background:auto,opaquehoặctransparent. Nền trong suốt cầnpng;transparentvớijpegtrả về20001với thông báo nêu tênbackground.n: từ 1 đến 10 ảnh mỗi yêu cầu. Bạn bị tính phí theo số ảnh được giao.moderation:autohoặclow.
Truyền ảnh tham chiếu và mặt nạ thế nào?
Dưới dạng URL, không bao giờ dưới dạng tệp hay base64. images nhận từ 1 đến 16 đối tượng có dạng {"image_url": "https://..."}, và việc gửi trường này biến yêu cầu thành một lần chỉnh sửa. mask nhận một đối tượng cùng dạng: một ảnh PNG có kích thước bằng ảnh tham chiếu đầu tiên, trong đó vùng trong suốt đánh dấu phần cần thay đổi. Tài liệu tham chiếu liệt kê giới hạn về tệp.
Câu hỏi thường gặp
GPT Image 2 có hỗ trợ 4K không?
Có, trong các giới hạn nêu trên. 3840x2160 cho 16:9 và 2160x3840 cho 9:16 là các khung ảnh lớn nhất, còn 2880x2880 là ảnh vuông lớn nhất.
Có thể gửi tỷ lệ khung hình thay cho pixel không?
Với API thì không. Hãy quy đổi tỷ lệ thành kích thước WIDTHxHEIGHT trước, dùng bảng ở trên hoặc Playground, nơi hiển thị kích thước chính xác trước khi gửi.
Kích thước và chất lượng mặc định là gì?
Cả hai đều mặc định là auto, tức để mô hình tự chọn. Hãy gửi giá trị tường minh khi bạn cần đầu ra dự đoán được.
Gửi pixel, đặt chất lượng, đọc thông báo lỗi
Hầu như mọi vấn đề về tham số đều thuộc một trong ba loại: gửi tỷ lệ thay cho kích thước, gửi một trường mà API không chấp nhận, hoặc một giá trị nằm ngoài giới hạn. Với loại thứ nhất và thứ ba, thông báo lỗi nêu tên trường; thông báo chung không nêu trường nào chỉ ra loại thứ hai. Hãy mở trang này cạnh tài liệu tham chiếu GPT Image 2 API trong lúc tích hợp.
