Tạo hình ảnh GPT-Image-2

• Mô hình: gpt-image-2
• Điểm cuối: POST https://apimaster.ai/v1/images/generations
• Chế độ: Bất đồng bộ — trả về task_id, sau đó thăm dò tác vụ
• Tính năng: Chuyển văn bản thành hình ảnh; chuyển hình ảnh thành hình ảnh với tối đa 16 hình ảnh tham chiếu (URL + base64 hỗn hợp)

Xác thực

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Tham số body

Trường	Loại	Bắt buộc	Ghi chú
model	string	có	gpt-image-2
prompt	string	có	Mô tả cảnh; áp dụng kiểm duyệt an toàn
n	integer	không	Chỉ 1 (số, không có dấu ngoặc kép)
size	string	không	Tỷ lệ khung hình, mặc định 1:1
resolution	string	không	1k / 2k / 4k, mặc định 1k
image_urls	array	không	Hình ảnh tham chiếu → chuyển hình ảnh thành hình ảnh
official_fallback	boolean	không	Dự phòng kênh chính thức, mặc định false

Giá trị size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, hoặc chuỗi pixel như 3840x2160.

Độ phân giải (mẫu pixel)

Kích thước	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Tất cả 15 tỷ lệ đều hỗ trợ 4K.

image_urls

• Tối đa 16 hình ảnh
• URL công khai và base64 data URI có thể được trộn lẫn
• Bỏ qua size để theo độ phân giải đầu vào; đặt size để buộc tỷ lệ khung hình đầu ra

Ví dụ

Tối thiểu văn bản thành hình ảnh

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Phản hồi gửi

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Ý nghĩa
400	Tham số không hợp lệ
401	Khóa API sai
402	Số dư không đủ
429	Giới hạn tốc độ

Thăm dò kết quả tác vụ

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL hình ảnh: data.result.images[0].url[0]

Trạng thái	Ý nghĩa
submitted	Đã gửi
processing	Đang xử lý
completed	Hoàn thành
failed	Thất bại (xem lỗi)

Thăm dò sau 10–20 giây, mỗi 3–5 giây. Hàng loạt: POST https://apimaster.ai/v1/tasks/batch với {"task_ids":[...]}.

Ghi chú

• Chỉ bất đồng bộ — không có URL hình ảnh đồng bộ trong phản hồi tạo.
• Ưu tiên size cho tỷ lệ khung hình; tránh lặp lại tỷ lệ trong prompt.
• Tính phí theo bậc độ phân giải; xem bảng điều khiển cho tài khoản của bạn.

So sánh với kênh chính thức.