Hướng dẫn API GPT Image 2.6: bản nháp, bản hoàn chỉnh và những điểm cần lưu ý khi di chuyển

AIHubMixĐọc 8 phút
Hướng dẫn API GPT Image 2.6: bản nháp, bản hoàn chỉnh và những điểm cần lưu ý khi di chuyển

Chuyển một lệnh gọi tạo ảnh cơ bản từ GPT Image 2.5 sang 2.6 chỉ cần đổi model ID. Các endpoint giữ nguyên, mức giá token giữ nguyên và ba kích thước được đề xuất cũng vậy. Những điểm cần chú ý là Batch — có trên 2.5 nhưng không có trên 2.6; công cụ tạo ảnh của Responses — được tài liệu OpenAI mô tả khác nhau giữa phiên bản 2.5 và 2.6; và các tùy chọn điều khiển — complexity, SVG, GIF và markup — được ghi trong tài liệu Image API của OpenAI nhưng chưa có trong lược đồ tham số đã công bố của AIHubMix.

Hướng dẫn này thực hiện một tác vụ tiêu biểu qua AIHubMix: tạo poster kích thước 1536x1024 có tiêu đề và ảnh sản phẩm. Quy trình bắt đầu bằng ba bản nháp Flare giá rẻ, chọn một bản rồi kết xuất bản hoàn chỉnh bằng Sunburst, đồng thời ghi chi phí cho mỗi bước. Trong quá trình đó, bài viết cũng đề cập các vấn đề khi di chuyển có thể âm thầm gây lỗi thay vì báo lỗi rõ ràng.

Những gì vẫn giữ nguyên

Hai model 2.6 là gpt-image-2.6-sunburst và gpt-image-2.6-flare. Cả hai đều được gọi qua v1/images/generations và v1/images/edits; không model nào có bí danh gpt-image-2.6 thông thường. Giá đầu vào văn bản là $5 mỗi triệu token, đầu vào hình ảnh là $8 và đầu ra hình ảnh là $30, hoàn toàn giống 2.5 và GPT Image 2.

Điều đó có nghĩa là quy trình được xây dựng quanh Image API vẫn giữ nguyên cấu trúc yêu cầu. Thứ thay đổi là chuỗi model, và chỉ khi bạn muốn dùng model mới. Theo trang model của AIHubMix, tuyên bố về tốc độ — nhanh hơn 50% đối với cả dòng — là lý do chính để chuyển đổi ngay từ ngày đầu.

Những điểm cần lưu ý khi di chuyển

Không còn Batch

Đây là tính năng duy nhất mà ưu thế của 2.5 rõ ràng không thể bàn cãi. Trang model GPT Image 2.5 liệt kê v1/batch là được hỗ trợ, và giá Batch cho đầu ra hình ảnh là $15 mỗi triệu token thay vì $30. Trang model GPT Image 2.6 ghi Batch là không được hỗ trợ, còn bảng giá Batch không có cả hai model 2.6.

Nếu bạn chạy các tác vụ tạo ảnh qua đêm, đừng chuyển chúng sang 2.6. Hãy tiếp tục dùng 2.5 hoặc chia khối lượng công việc: bản nháp tương tác chạy trên 2.6, kết xuất hàng loạt chạy trên 2.5. Tài liệu hình ảnh của AIHubMix không liệt kê endpoint Batch nào, nên lựa chọn này chỉ áp dụng cho các lệnh gọi trực tiếp đến OpenAI.

Cần kiểm tra các quy trình dùng Responses

Tài liệu của chính OpenAI có thông tin không thống nhất về 2.5 ở điểm này. Nhật ký thay đổi tháng 9 liệt kê công cụ tạo ảnh của Responses API bên cạnh Image API, nhưng trang model 2.5 ghi Responses là không được hỗ trợ. Với 2.6, thông tin rõ ràng hơn: trang model ghi Responses là không được hỗ trợ, còn nhật ký thay đổi tháng 11 chỉ liệt kê v1/images/generations và v1/images/edits.

Nếu mã của bạn gọi 2.5 qua Responses, hãy thêm một bài kiểm tra smoke test trước khi đổi model ID. Lỗi ở đây sẽ được báo rõ, nhưng chỉ khi có kiểm thử; một quy trình âm thầm chuyển sang model khác còn tệ hơn lỗi 400.

Các tùy chọn điều khiển mới chỉ dành cho Image API

Hướng dẫn tạo ảnh liệt kê complexity, chỉnh sửa có hướng dẫn bằng markup, đầu ra SVG và đầu ra GIF động cho Image API. Không tùy chọn nào trong số này dùng được qua công cụ tạo ảnh của Responses; SVG và GIF chỉ dùng để tạo ảnh, không dùng được với /v1/images/edits.

Mỗi tùy chọn đều có giới hạn riêng. SVG yêu cầu n=1 và không hỗ trợ truyền phát, ảnh từng phần, output_compression hoặc prompt_rewriter. GIF dùng frame_count (mặc định là 9) và frame_duration_ms (mặc định là 200), chỉ dùng để tạo ảnh và cũng không hỗ trợ truyền phát, ảnh từng phần, output_compression tùy chỉnh hoặc prompt_rewriter. Chỉnh sửa bằng markup cần ảnh gốc làm ảnh đầu vào thứ nhất và một tệp PNG trong suốt riêng có cùng kích thước; mỗi ảnh không được vượt quá 16,777,216 pixel và tệp markup bị giới hạn ở 50 MB. Không kết hợp markup với mask hoặc prompt_rewriter.

SVG còn có quy tắc tính phí riêng: bạn trả theo mức giá của model hình ảnh cho ảnh tham chiếu và theo mức giá của model tạo nội dung cho số token dùng để tạo SVG. Tổng chi phí phụ thuộc vào cả hai, vì vậy ước tính thông thường theo mỗi ảnh không bao gồm khoản này.

Tài liệu về chất lượng và kích thước không thống nhất

Với 2.5, OpenAI ghi rõ năm mức chất lượng ngoài auto: low, medium, high, xhigh và max. Với 2.6, công cụ tính chi phí trong hướng dẫn liệt kê cả năm mức cho cả hai cách tạo ảnh, tài liệu tham chiếu API chỉ gắn xhigh và max với các snapshot 2.5, còn bảng giá theo ảnh của AIHubMix — nguồn cho các chi phí bên dưới — chỉ tính giá cho low, medium, high và auto.

Các mức an toàn để dùng với 2.6 hiện nay là low, medium, high và auto. Kích thước cũng cần thận trọng tương tự: giá trị WIDTHxHEIGHT tùy chỉnh được ghi trong tài liệu GPT Image 2 và 2.5, còn hướng dẫn 2.6 đề xuất 1024x1024, 1536x1024 và 1024x1536. Hãy dùng ba kích thước được đề xuất cho đến khi tài liệu 2.6 nhất quán.

Chuyển từ 1.5, chất lượng cao ở kích thước 1024x1024 sẽ tốn kém hơn

GPT Image 1.5 và 1-mini sẽ ngừng hoạt động vào ngày December 1, 2026, trong đó 2.5 được nêu là sản phẩm thay thế. Nếu bạn chủ yếu kết xuất ở kích thước 1024x1024 với chất lượng cao, việc chuyển đổi không hề rẻ: bảng giá 1.5 của OpenAI ghi chất lượng cao là $0.133, còn ước tính cho 2.6 của AIHubMix là $0.211, cao hơn khoảng 59%. Mức medium tăng từ $0.034 lên $0.053, còn mức low giảm từ $0.009 xuống $0.006. Ở kích thước 1536x1024, chất lượng cao của 1.5 là $0.200, nên mức $0.165 của 2.6 rẻ hơn ở kích thước đó.

Hãy chạy cùng một khối lượng công việc trên 2.5 trước khi cho rằng 2.6 sẽ rẻ hơn: mức giá token giống hệt nhau, nên sự khác biệt giữa hai model 2.x nằm ở lượng token tiêu thụ, không phải giá niêm yết.

Gọi 2.6 qua AIHubMix

AIHubMix cung cấp cả hai model 2.6 với mức giá chính thức. Tài liệu tạo ảnh của AIHubMix mô tả endpoint mới hơn, POST https://aihubmix.com/ai/v1/images/generations. Endpoint này chấp nhận model, prompt, n, size, output_format, image, images, mask, async, extra và hai trường webhook.

Chi tiết quan trọng là vị trí của quality. Trên /ai/v1/images/generations không có trường quality ở cấp cao nhất; trường này phải nằm bên trong extra:

curl -s https://aihubmix.com/ai/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
    "size": "1024x1024",
    "n": 3,
    "extra": { "quality": "low" }
  }'

Phản hồi có một hoặc nhiều URL đầu ra. Các URL này chỉ có hiệu lực trong thời gian ngắn — khoảng 30 phút — và phải được tải xuống kèm cùng header Authorization: Bearer $AIHUBMIX_API_KEY:

curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png

Tài liệu AIHubMix khuyến nghị dùng /ai/v1 cho các tích hợp mới: các endpoint /v1 tương thích với OpenAI có thể chưa hỗ trợ những model mới nhất, và danh sách model trong tài liệu tham chiếu hình ảnh cũ có gpt-image-2, gpt-image-1.5, gpt-image-1-mini cùng các model DALL·E, nhưng không có 2.6. Lược đồ theo từng model có liệt kê mục /v1/images/generations cho 2.6, nhưng /ai/v1 là đường dẫn AIHubMix ghi trong tài liệu dành cho 2.6 và là đường dẫn bổ sung tác vụ bất đồng bộ cùng webhook.

Những gì lược đồ chưa cung cấp

Lược đồ 2.6 được AIHubMix công bố chỉ chấp nhận các giá trị output_format là png, jpeg và webp. Lược đồ không có complexity, markup, frame_count hoặc frame_duration_ms, cũng không hỗ trợ đầu ra svg hoặc gif. Có thể xem lược đồ mà không cần xác thực tại https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints; hãy kiểm tra lược đồ này trước khi dựa vào bất kỳ tính năng nào trong số đó thông qua gateway.

Đây là khoảng trống trong lược đồ, không phải lỗi đã được xác nhận qua kiểm thử: các tính năng này có trong tài liệu phía OpenAI, và gateway có thể bổ sung chúng sau. Cho đến khi lược đồ liệt kê các tính năng đó, hãy lên kế hoạch gọi trực tiếp OpenAI cho các tác vụ SVG, GIF và markup.

Các lỗi có thể gặp

Trạng thái Ý nghĩa Cách xử lý
400 Lỗi tham số, thường được chuyển tiếp từ nhà cung cấp Kiểm tra prompt, kích thước và n
401 Thiếu khóa hoặc khóa không hợp lệ Kiểm tra header Authorization
402 Không đủ hạn mức Nạp thêm tín dụng
403 Bị từ chối quyền Kiểm tra tài khoản, quyền của khóa và các giới hạn IP
429 Bị giới hạn tốc độ Chờ một lúc rồi thử lại
503 Không có kênh nào xử lý được yêu cầu Kiểm tra model ID, thử lại sau

Phần nội dung lỗi của AIHubMix có chứa mã truy vết tid. Hãy lưu lại mã này để liên hệ bộ phận hỗ trợ và đừng gửi lại nguyên trạng yêu cầu gây lỗi 400. Đây là quy ước của /ai/v1; các endpoint /v1 cũ báo lỗi không đủ hạn mức bằng 403 insufficient_user_quota thay vào đó.

Quy trình: ba bản nháp, một bản hoàn chỉnh

Tác vụ là tạo poster có ảnh sản phẩm và tiêu đề. Prompt được giữ nguyên; chỉ model, kích thước và chất lượng thay đổi.

Bước 1 — tạo bản nháp bằng Flare. Gửi một yêu cầu với n=3, kích thước 1024x1024 và chất lượng low để nhận ba phương án. Với chi phí ước tính $0.006 mỗi ảnh, bước này tốn $0.018.

Bước 2 — chọn một phương án. Đây là phần ít tốn kém trong quy trình và cũng là phần hưởng lợi nhiều nhất từ tốc độ của model. Tạo ba bản nháp trong một lần gọi là mức ngân sách thông thường, không phải khoản chi xa xỉ.

Bước 3 — kết xuất bản hoàn chỉnh bằng Sunburst. Nhập lại prompt cho bố cục đã chọn ở kích thước 1536x1024 và chất lượng high. Với chi phí ước tính $0.165 mỗi ảnh, đây là bước tốn kém nhất; một ảnh hoàn chỉnh có giá khoảng gấp 28 lần một ảnh nháp, hoặc khoảng gấp chín lần bước tạo ba bản nháp.

curl -s https://aihubmix.com/ai/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
    "size": "1536x1024",
    "n": 1,
    "extra": { "quality": "high" }
  }'

Bước 4 — tính tổng. Chi phí ước tính là $0.018 cho các bản nháp cộng với $0.165 cho bản hoàn chỉnh, tổng cộng $0.183 cho bốn ảnh đầu ra. Nếu kết xuất bản hoàn chỉnh ở chất lượng medium, chi phí là $0.041 và tổng lượt chạy là $0.059. Token văn bản đầu vào chỉ thêm một phần nhỏ của một cent với độ dài prompt này; thao tác chỉnh sửa sẽ cộng thêm token đầu vào hình ảnh với mức $8 mỗi triệu.

Con số này cho thấy hai model không có khác biệt về chi phí: cùng bốn ảnh trên 2.5 cũng tốn như vậy vì ước tính theo ảnh của AIHubMix giống nhau. Lý do để dùng 2.6 là vòng lặp tạo bản nháp nhanh hơn và khả năng chuyển các tác vụ SVG hoặc GIF sang OpenAI sau này, chứ không phải để giảm hóa đơn.

Danh sách kiểm tra khi di chuyển

  • Thay gpt-image-2.5-sunburst và gpt-image-2.5-flare bằng các ID 2.6 ở những nơi bạn muốn dùng model mới; giữ nguyên các tác vụ Batch trên 2.5.
  • Xác nhận xem quy trình nào có dùng công cụ tạo ảnh của Responses hay không; tài liệu 2.6 chỉ ghi Image API.
  • Chỉ dùng low, medium, high hoặc auto cho chất lượng và ba kích thước được đề xuất cho đến khi tài liệu 2.6 ổn định.
  • Trên /ai/v1 của AIHubMix, đặt chất lượng trong extra; với 2.6, hãy dùng /ai/v1, đường dẫn AIHubMix khuyến nghị cho các tích hợp mới.
  • Tải xuống các URL đầu ra trong vòng 30 phút bằng header Bearer.
  • Đừng cho rằng complexity, markup, SVG hoặc GIF hoạt động qua AIHubMix cho đến khi schema liệt kê chúng.
  • Nếu đang dùng 1.5, hãy dự trù việc ngừng hỗ trợ vào ngày 1 tháng 12 và kiểm tra lại chi phí ở chất lượng cao.

Câu hỏi thường gặp

Tôi có cần đổi endpoint để dùng GPT Image 2.6 không?
Trên API của OpenAI thì không. API này dùng v1/images/generations và v1/images/edits, giống như 2.5; chỉ ID model thay đổi. Trên AIHubMix, hãy dùng /ai/v1/images/generations như đã mô tả ở trên.

GPT Image 2.6 có rẻ hơn 2.5 không?
Không. Mức giá theo token giống hệt nhau: $5 cho mỗi triệu token đầu vào văn bản, $8 cho mỗi triệu token đầu vào hình ảnh và $30 cho mỗi triệu token đầu ra hình ảnh.

Tại sao tôi không thể dùng Batch với GPT Image 2.6?
Các trang model 2.6 của OpenAI đánh dấu Batch là không được hỗ trợ, còn bảng giá Batch có liệt kê 2.5 nhưng không có 2.6. Batch là quy trình rõ ràng nhất mà 2.5 vẫn là lựa chọn tốt hơn.

Tôi đặt chất lượng trên AIHubMix như thế nào?
Với 2.6, trên /ai/v1/images/generations, hãy đặt giá trị này trong extra.quality. Endpoint tương thích với OpenAI /v1/images/generations có trường quality ở cấp cao nhất, nhưng AIHubMix khuyến nghị dùng /ai/v1 cho các tích hợp mới; hãy dùng /ai/v1 với 2.6.

Tôi có thể tạo SVG hoặc GIF qua AIHubMix không?
Theo schema hiện tại thì không; schema liệt kê png, jpeg và webp, nhưng không có complexity, markup, số khung hình hay đầu ra SVG/GIF. Các tính năng đó được ghi trong tài liệu Image API của OpenAI; hãy kiểm tra schema trước khi dựa vào chúng qua gateway.

URL đầu ra của AIHubMix có hiệu lực trong bao lâu?
Khoảng 30 phút. Hãy tải chúng xuống bằng cùng token Bearer và tự lưu tệp.

GPT Image 1.5 sẽ ra sao?
Model này sẽ ngừng hoạt động vào ngày 1 tháng 12 năm 2026. OpenAI nêu 2.5 là model thay thế, nhưng ở độ phân giải 1024x1024 và chất lượng cao, 2.6 có giá mỗi ảnh cao hơn 1.5; ở độ phân giải 1536x1024 thì giá thấp hơn.

Đọc tiếp: loạt bài về GPT Image 2.6

Bài viết so sánh trình bày các bảng giá, tuyên bố về tốc độ và những trường hợp 2.5 vẫn chiếm ưu thế; đây là nơi nên bắt đầu nếu bạn chưa quyết định có nên chuyển đổi hay không.
GPT Image 2.6 so với 2.5: nâng cấp có đáng không?

Nguồn

Một cổng duy nhất tới nhiều nhà cung cấp AI. Sẵn sàng cho môi trường production.

Truy cập AIHubMix