GPT Image 2.6

GPT Image 2.6 nhận prompt văn bản và ảnh tham chiếu tùy chọn. Gửi một lần tới POST /v1/images/generations, giữ ID tác vụ và truy vấn GET /v1/tasks/{id} để lấy kết quả. Tệp hoàn chỉnh được trả về dưới dạng URL.

ID mô hình và giá

Dùng GET /v1/models để xem các mô hình khả dụng với khóa của bạn. Các ID Sunburst đã cấu hình là gpt-image-2.6-sunburst-official và gpt-image-2.6-sunburst. ID Flare, khi có trong danh sách, dùng cùng bộ tham số. ID mô hình không có hậu tố dùng nhóm Default; các nhóm bổ sung dùng ID model:group hiển thị trong danh sách mô hình khả dụng.

Xem giá hiện tại và Playground. Mô hình tính theo token quyết toán theo mức sử dụng thực tế; mô hình tính theo ảnh dùng giá ảnh đã cấu hình. Phản hồi SVG báo cáo riêng token của mô hình viết mã SVG trong svg_usage, tính theo giá SeedRouter riêng của mô hình đó.

Tạo ảnh

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

Phản hồi chứa id. Truy vấn ID đó thay vì gửi lại yêu cầu tạo ảnh:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Khi hoàn tất, output.data chứa các đối tượng có url. Tải tệp từ URL để giữ định dạng gốc và mọi khung hình của GIF. Tác vụ thất bại có error và không bị tính phí. Xem trạng thái và truy vấn tác vụ.

Tham số

Có 18 trường cấp cao nhất. Chỉ model và prompt là bắt buộc. Trường tùy chọn nhận null, tương đương với bỏ qua. Trường không xác định bị loại bỏ. Giá trị không hợp lệ của tham số được hỗ trợ sẽ bị chặn khi kiểm tra trước khi tạo ảnh.

URL ảnh tham chiếu phải dùng HTTP hoặc HTTPS và không chứa thông tin xác thực. Không chấp nhận ID tệp, base64 nhúng và tải lên multipart; hãy tải tệp lên trước rồi cung cấp URL công khai. Yêu cầu dùng truy vấn tác vụ bất đồng bộ thay cho stream hoặc partial_images. Bộ tham số này không cung cấp input_fidelity, response_format và prompt_rewriter.

Kích thước ảnh

Khi tạo PNG, JPEG và ảnh tham chiếu cho SVG, mỗi chiều phải chia hết cho 16 và không vượt quá 3840 pixel. Tổng số pixel phải từ 655.360–8.294.400 và tỷ lệ khung hình phải từ 1:3 đến 3:1. Ví dụ: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

Kích thước GIF phải là bội số dương của 16, hoặc dùng auto. GIF có tổng ngân sách pixel riêng, dùng chung cho số khung hình, kích thước khung hình và n; OpenAI chưa công bố giới hạn bằng số. GIF 512x512 không áp dụng quy tắc số pixel tối thiểu của ảnh tĩnh.

GIF động

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

Có thể tạo GIF từ prompt hoặc yêu cầu tạo từ ảnh tham chiếu. Không kết hợp với mặt nạ hay nén. Quyền dùng tính năng xem trước có thể phụ thuộc vào quyền truy cập mô hình được chọn.

Khác biệt tài liệu, kiểm tra ngày 5 tháng 11 năm 2026: hướng dẫn tạo ảnh của OpenAI ghi 2–64 khung hình và 20–2000 ms, đồng thời nói endpoint chỉnh sửa không trả về GIF. Tài liệu tham khảo Images API ghi 2–16 khung hình, không có thời gian hiển thị tối đa và liệt kê đầu ra GIF khi chỉnh sửa. Yêu cầu tới API gốc ngày 5 tháng 11 năm 2026 khớp với tài liệu tham khảo: 17 khung hình bị từ chối, còn khung hình 3.000 ms được chấp nhận. API này tuân theo tài liệu tham khảo.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG chỉ dùng khi tạo mới và yêu cầu n: 1. Không gửi ảnh, mặt nạ, nét đánh dấu hoặc nén. Tệp là XML UTF-8 tĩnh chứa hình dạng vector; không hỗ trợ tập lệnh, tài nguyên bên ngoài và ảnh raster nhúng.

Khi có thể chọn mô hình viết mã SVG, thêm svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Nếu gửi rõ đối tượng svg, phải có model không rỗng. Bạn cũng có thể đặt svg.reasoning.effort thành none, minimal, low, medium, high, xhigh hoặc max; giá trị được hỗ trợ phụ thuộc vào mô hình viết mã được chọn. Bỏ reasoning để dùng mặc định của mô hình. OpenAI không công bố danh sách mô hình viết mã SVG được phép hay một mặc định chung. Nếu không thể chọn mô hình, bỏ toàn bộ đối tượng svg.

Kết quả hoàn chỉnh có thể chứa svg_usage với model, input_tokens, output_tokens, reasoning_tokens và total_tokens. Phần này tách biệt với usage của ảnh, không phải số token ảnh bổ sung.

Ảnh tham chiếu, mặt nạ và nét đánh dấu

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Ảnh tham chiếu hỗ trợ PNG, JPEG và WebP, tối đa 50 MB mỗi ảnh. Mặt nạ và nét đánh dấu phải là PNG, khớp kích thước ảnh tham chiếu đầu tiên sau khi áp dụng hướng ảnh. Nét đánh dấu phải chứa pixel trong suốt; cả nét đánh dấu và ảnh tham chiếu đầu tiên đều không được vượt quá 16.777.216 pixel, và tệp nét đánh dấu tối đa 50 MB. Mặt nạ và nét đánh dấu không được dùng cùng nhau.

Các trường phản hồi

Đầu ra ảnh hoàn chỉnh chứa created, data: [{url}] và, khi được báo cáo, size, quality, background, output_format, usage, svg_usage và safety_identifier. usage có thể tách token văn bản/ảnh đầu vào và đầu ra, cùng đầu vào đã lưu đệm. Đầu ra công khai không chứa byte ảnh base64 hay trường chi phí.

Lược đồ OpenAPI · Tài liệu tham khảo tạo ảnh OpenAI · Tài liệu tham khảo chỉnh sửa OpenAI · Hướng dẫn ảnh OpenAI