gpt-image-2.5-sunburst API

Sử dụng ID mẫu chính xác gpt-image-2.5-sunburst. Trường mô hình phải khớp chính xác với trang này.

Đầu ra mẫugpt-image-2.5-sunburstPOST /v1/images/generations

Thông số: size=1536x1024n=1

Câu lệnh: The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

Yêu cầu tạo ra mẫu này

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

Xác thực và điểm cuối

Sử dụng khóa API Modelflare với https://modelflare.dev/v1. Điểm vào cổng là POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Tạo hình ảnh

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Ghi chú yêu cầu

GPT Image 2.5 Sunburst hướng tới việc tạo và chỉnh sửa có độ trung thực cao hơn, khả năng kiểm soát cao hơn; giữ nguyên các điều khiển images[], image[], mask, xhigh/max và đầu ra cho cả hai thao tác.

Tham số yêu cầu

GPT Image 2.5 sử dụng API hình ảnh tương thích với OpenAI. Thế hệ sử dụng JSON; chỉnh sửa chấp nhận tham chiếu hình ảnh JSON hoặc tệp nhiều phần; phản hồi trả về dữ liệu hình ảnh Base64 trong data[].b64_json.

Cánh đồng	Bắt buộc	Ghi chú
model	Có	gpt-image-2.5-sunburst
prompt	Có	Hướng dẫn tạo hoặc chỉnh sửa, 1–32.000 ký tự
images[]	Có điều kiện	Đối với các chỉnh sửa JSON, tối đa 16 đối tượng file_id hoặc image_url
images[].file_id	Có điều kiện	ID API tệp đã tải lên
images[].image_url	Có điều kiện	URL hình ảnh hoặc URL dữ liệu Base64; URL dữ liệu được giới hạn ở 20.971.520 ký tự
image	Có điều kiện	Một tệp nguồn nhiều phần; sử dụng image[] cho nhiều tập tin
image[]	Có điều kiện	Đối với chỉnh sửa nhiều phần, tối đa 16 tệp nguồn
mask	Không	Mặt nạ alpha phù hợp với định dạng/kích thước nguồn đầu tiên và dưới 50 MB
size	Không	auto hoặc WIDTHxHEIGHT tùy chỉnh; Bội số 16 pixel, tỷ lệ khung hình 1:3–3:1, cạnh tối đa 3.840px và tổng số 655.360–8.294.400 pixel
quality	Không	low / medium / high / xhigh / max / auto; mặc định auto
background	Không	auto / opaque / transparent; nền trong suốt yêu cầu đầu ra PNG hoặc WebP
output_format	Không	png / jpeg / webp; mặc định png
output_compression	Không	0–100 cho JPEG/WebP, mặc định 100; bị bỏ qua đối với PNG
moderation	Không	auto / low; mặc định auto
n	Không	1–10 đầu ra; mặc định 1

Giới hạn phản hồi và đầu vào

GPT Image 2.5 Flare và Sunburst hỗ trợ tối đa 16 đầu vào chỉnh sửa. Các chỉnh sửa JSON sử dụng images[] với file_id hoặc image_url; chỉnh sửa nhiều phần sử dụng image/image[], với mỗi ảnh nguồn và mặt nạ dưới 50 MB. Lời nhắc có từ 1–32.000 ký tự; hỗ trợ chất lượng low/medium/high/xhigh/max/auto; quy tắc kích thước là bội số 16 pixel, tỷ lệ khung hình 1:3–3:1, cạnh tối đa 3.840px và tổng số 655.360–8.294.400 pixel. Nền trong suốt yêu cầu PNG hoặc WebP; nén chỉ áp dụng cho JPEG/WebP và bị bỏ qua đối với PNG. Các độ phân giải trên 2560x1440 chỉ mang tính thử nghiệm. Đọc data[].b64_json; không gửi DALL·E-only response_format. Flare là chế độ mặc định nhanh, chất lượng cao để tạo và chỉnh sửa hàng ngày; Sunburst dành cho công việc có độ trung thực cao hơn, khả năng kiểm soát cao hơn.

Chỉnh sửa hình ảnh

GPT Image 2.5 hỗ trợ tham chiếu hình ảnh JSON và tải lên tệp nhiều phần thông qua /v1/images/edits. JSON chấp nhận tối đa 16 đối tượng sử dụng file_id hoặc image_url; multipart chấp nhận tối đa 16 tệp nguồn. Không kết hợp images với image/image[] trong một yêu cầu.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=xhigh" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Hình dạng phản hồi

Đọc kết quả được tạo và chỉnh sửa từ data[]. GPT Image 2.5 trả về dữ liệu hình ảnh Base64; không coi phản hồi là đầu ra URL.

Cánh đồng	Ghi chú
created	Thời gian tạo dưới dạng dấu thời gian Unix tính bằng giây
data	Kết quả hình ảnh được tạo hoặc chỉnh sửa
data[].b64_json	Dữ liệu hình ảnh được mã hóa Base64
background	Chế độ nền cuối cùng: opaque hoặc transparent
output_format	Định dạng ảnh trả về: png, jpeg hoặc webp
quality	Cấp chất lượng được sử dụng
size	Kích thước cuối cùng là WIDTHxHEIGHT

Lỗi và tác vụ không thành công

Các tham số mô hình không hợp lệ trả về 4xx với ID yêu cầu; sử dụng các trường phản hồi và thông báo lỗi được xác định bởi hợp đồng mẫu đã chọn.

Phạm vi được hỗ trợ

Trang này bao gồm các cuộc gọi chỉnh sửa và tạo mô hình Modelflare. Tính năng làm giàu bản đồ hoặc tìm kiếm, quản lý giọng nói và quản lý thư viện thành phần là các API tài nguyên nằm ngoài bề mặt lệnh gọi mô hình công khai này và không phải là các trường yêu cầu bắt buộc.

Định giá và thanh toán

Mô hình này sử dụng thanh toán dựa trên mã thông báo. Xem trang định giá mẫu để biết giá khách hàng hiện tại, giá niêm yết tham khảo và thông số kỹ thuật đầy đủ.

Ghi chú

Trang này ghi lại giao diện công cộng của Modelflare; các trường và giới hạn hiển thị ở đây là hợp đồng hiện tại.