Chỉnh sửa hình ảnh

Tải ảnh nguồn dưới dạng multipart/form-data và chỉnh sửa bằng prompt văn bản — tương thích với OpenAI client.images.edit(). Bên trong tái sử dụng pipeline image-to-image; phản hồi luôn là JSON đồng bộ. mask chưa được hỗ trợ, response_format chỉ hỗ trợ URL (b64_json bị từ chối).

POST/api/v1/images/edits

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

imagebắt buộc

file

Tệp ảnh nguồn cần chỉnh sửa. Lặp lại trường image (hoặc dùng image[]) cho nhiều tệp — tối đa 8 tệp, mỗi tệp 10 MB, MIME phải là image/*.

≤ 8 files, ≤ 10 MB each, image/*

promptbắt buộc

string

Mô tả văn bản của chỉnh sửa cần áp dụng.

minLength: 1

Example: "change the background to a night city"

model

string

Model chỉnh sửa ảnh. Nếu bỏ qua, áp dụng mặc định máy chủ (hiện là gpt-5.4-image-2).

Example: "openai/gpt-5.4-image-2"

n

integer

Số lượng kết quả cần tạo, 1–10.

1–10

Example: 1

size

string

Kích thước đầu ra, phải là chuỗi pixel "<rộng>x<cao>" (ví dụ 1024x1024); định dạng khác sẽ bị bỏ qua âm thầm.

format: <width>x<height>

Example: "1024x1024"

Hướng dẫn chi tiết →

POST /api/v1/images/edits

1
2
3
4
5
curl https://bazaarlink.ai/api/v1/images/edits \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -F model="openai/gpt-5.4-image-2" \
  -F image=@cat.png \
  -F prompt="change the background to a night city"

Ví dụ phản hồi

Thành công. Luôn trả về JSON đồng bộ (luồng SSE được xử lý nội bộ) — tương thích với client.images.edit().

1
2
3
4
5
6
7
8
{
  "created": 1753500000,
  "data": [
    {
      "url": "https://bazaarlink.ai/api/v1/images/proxy/eyJhbGciOi..."
    }
  ]
}