# ChatGPT Images 2.6 API Tài liệu tham khảo API đầy đủ cho các mô hình ChatGPT Images 2.6 Flare và Sunburst. ## Các biến thể mô hình API này hỗ trợ bốn biến thể mô hình: | Mô hình | ID | Mô tả | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | Tạo ảnh từ văn bản với các tùy chọn kiểm soát độ phân giải và chất lượng | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | Chỉnh sửa ảnh và kết hợp nhiều ảnh | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | Tạo ảnh từ văn bản với các tùy chọn kiểm soát độ phân giải và chất lượng | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | Chỉnh sửa ảnh và kết hợp nhiều ảnh | ## So sánh nhanh Flare và Sunburst có chung các tùy chọn yêu cầu sau. | Tính năng | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | Đầu vào | Câu lệnh văn bản | Ảnh + câu lệnh văn bản | | Tùy chọn độ phân giải | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | Tùy chọn chất lượng | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | Chất lượng mặc định | `medium` | `medium` | | Tỷ lệ khung hình | 10 tùy chọn | 10 tùy chọn | | Ảnh đầu vào | Không | Bắt buộc (1–16 ảnh) | | Định dạng đầu ra | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | Định dạng đầu ra mặc định | `png` | `png` | ### Tỷ lệ khung hình được hỗ trợ `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (Tạo ảnh từ văn bản) ### Điểm cuối ``` POST /api/v1/image/task ``` ### Xác thực ``` Authorization: Bearer YOUR_API_KEY ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"gpt-image-2.6-flare"` | | `prompt` | string | Câu lệnh tạo ảnh | | `width` | integer | Giá trị tỷ lệ chiều rộng, chẳng hạn `16` cho `16:9`; không phải kích thước tính bằng pixel | | `height` | integer | Giá trị tỷ lệ chiều cao, chẳng hạn `9` cho `16:9`; không phải kích thước tính bằng pixel | | `resolution` | string | `"1k"`, `"2k"`, hoặc `"4k"` | Tỷ lệ width:height phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên. #### Không bắt buộc | Tham số | Kiểu | Mặc định | Mô tả | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, hoặc `"max"` | | `output_format` | string | `"png"` | Định dạng đầu ra: `"png"`, `"jpeg"`, `"webp"`, `"gif"` hoặc `"svg"`. Sử dụng `"gif"` cho ảnh động GIF hoặc `"svg"` cho đầu ra vectơ SVG | | `frame_count` | integer | `9` | Số khung hình GIF, từ `2` đến `16`. Chỉ áp dụng khi `output_format` là `"gif"` | | `frame_duration_ms` | integer | `200` | Thời lượng khung hình GIF tính bằng mili giây, từ `20` đến `2000`. Chỉ áp dụng khi `output_format` là `"gif"` | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (Chỉnh sửa ảnh) ### Điểm cuối ``` POST /api/v1/image/task ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"gpt-image-2.6-flare-edit"` | | `prompt` | string | Mô tả các chỉnh sửa mong muốn | | `image_url_list` | string[] | URL ảnh đầu vào; tối thiểu 1 và tối đa 16 ảnh, mỗi ảnh có dung lượng dưới 50 MB | | `width` | integer | Giá trị tỷ lệ chiều rộng, chẳng hạn `16` cho `16:9`; không phải kích thước tính bằng pixel | | `height` | integer | Giá trị tỷ lệ chiều cao, chẳng hạn `9` cho `16:9`; không phải kích thước tính bằng pixel | | `resolution` | string | `"1k"`, `"2k"`, hoặc `"4k"` | Tỷ lệ width:height phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên. #### Không bắt buộc | Tham số | Kiểu | Mặc định | Mô tả | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, hoặc `"max"` | | `output_format` | string | `"png"` | Định dạng đầu ra: `"png"`, `"jpeg"` hoặc `"webp"` | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (Tạo ảnh từ văn bản) ### Điểm cuối ``` POST /api/v1/image/task ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"gpt-image-2.6-sunburst"` | | `prompt` | string | Câu lệnh tạo ảnh | | `width` | integer | Giá trị tỷ lệ chiều rộng, chẳng hạn `16` cho `16:9`; không phải kích thước tính bằng pixel | | `height` | integer | Giá trị tỷ lệ chiều cao, chẳng hạn `9` cho `16:9`; không phải kích thước tính bằng pixel | | `resolution` | string | `"1k"`, `"2k"`, hoặc `"4k"` | Tỷ lệ width:height phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên. #### Không bắt buộc | Tham số | Kiểu | Mặc định | Mô tả | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, hoặc `"max"` | | `output_format` | string | `"png"` | Định dạng đầu ra: `"png"`, `"jpeg"`, `"webp"`, `"gif"` hoặc `"svg"`. Sử dụng `"gif"` cho ảnh động GIF hoặc `"svg"` cho đầu ra vectơ SVG | | `frame_count` | integer | `9` | Số khung hình GIF, từ `2` đến `16`. Chỉ áp dụng khi `output_format` là `"gif"` | | `frame_duration_ms` | integer | `200` | Thời lượng khung hình GIF tính bằng mili giây, từ `20` đến `2000`. Chỉ áp dụng khi `output_format` là `"gif"` | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (Chỉnh sửa ảnh) ### Điểm cuối ``` POST /api/v1/image/task ``` ### Tham số yêu cầu #### Bắt buộc | Tham số | Kiểu | Mô tả | |-----------|------|-------------| | `model_name` | string | Phải là `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | Mô tả các chỉnh sửa mong muốn | | `image_url_list` | string[] | URL ảnh đầu vào; tối thiểu 1 và tối đa 16 ảnh, mỗi ảnh có dung lượng dưới 50 MB | | `width` | integer | Giá trị tỷ lệ chiều rộng, chẳng hạn `16` cho `16:9`; không phải kích thước tính bằng pixel | | `height` | integer | Giá trị tỷ lệ chiều cao, chẳng hạn `9` cho `16:9`; không phải kích thước tính bằng pixel | | `resolution` | string | `"1k"`, `"2k"`, hoặc `"4k"` | Tỷ lệ width:height phải khớp với một trong các tỷ lệ khung hình được hỗ trợ ở trên. #### Không bắt buộc | Tham số | Kiểu | Mặc định | Mô tả | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"`, hoặc `"max"` | | `output_format` | string | `"png"` | Định dạng đầu ra: `"png"`, `"jpeg"` hoặc `"webp"` | ### Ví dụ yêu cầu ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Định dạng phản hồi ### Phản hồi ban đầu Cả bốn biến thể ChatGPT Images 2.6 đều trả về `task_id` để truy vấn định kỳ: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### Phản hồi truy vấn định kỳ Gửi `GET /api/v1/image/{task_id}` định kỳ để kiểm tra trạng thái: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### Các giá trị trạng thái - `submitted`: Tác vụ đã được tiếp nhận - `processing`: Đang tạo hoặc chỉnh sửa ảnh - `succeed`: Tác vụ đã hoàn tất thành công - `failed`: Tác vụ thất bại ## Thời gian xử lý Thời gian xử lý thay đổi tùy theo mô hình, thiết lập đầu ra, độ phức tạp của câu lệnh và số lượng ảnh tham chiếu. Tiếp tục truy vấn định kỳ cho đến khi trạng thái tác vụ là `succeed` hoặc `failed`; tác vụ đã gửi hoặc đang xử lý có thể chưa chứa ảnh kết quả. ## Các phương pháp tốt nhất 1. **Mô tả bố cục rõ ràng**: ChatGPT Images 2.6 cho kết quả tốt nhất khi câu lệnh mô tả rõ chủ thể, cách đóng khung, ánh sáng và phong cách mong muốn. 2. **Chọn tỷ lệ khung hình phù hợp với mục đích sử dụng**: Đặt tỷ lệ ngay từ đầu cho bài đăng mạng xã hội, biểu ngữ, trang sản phẩm hoặc bố cục biên tập. 3. **Sử dụng ảnh nguồn rõ nét để chỉnh sửa**: Ảnh đầu vào sắc nét, đủ sáng giúp giữ nguyên đặc điểm nhận dạng và nâng cao chất lượng chỉnh sửa cục bộ. 4. **Chỉ dùng ảnh tham chiếu phù hợp cho yêu cầu nhiều ảnh**: Với yêu cầu chỉnh sửa, chỉ cung cấp những ảnh cần thiết để tránh chỉ dẫn hình ảnh mâu thuẫn.