API chỉnh sửa ảnh

API chỉnh sửa ảnh sẽ chỉnh sửa dựa trên ảnh gốc theo prompt (đổi nền, thay đổi thành phần, tạo phong cách, v.v.), cả GPT-Image và các dòng hình ảnh Gemini đều có thể sử dụng.

Giao diện

POST https://api.4allapi.com/v1/images/edits

Định dạng multipart/form-data, các trường chính:

Trường	Mô tả
model	Tên mô hình ảnh, ví dụ gpt-image-2, gemini-3.1-flash-image
image	Tệp ảnh gốc (có thể nhiều ảnh, image[])
prompt	Chỉ dẫn chỉnh sửa

Ví dụ

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gpt-image-2" \
  -F image="@product.png" \
  -F prompt="Thay nền thành cảnh phòng khách Giáng Sinh ấm cúng, giữ nguyên chủ thể sản phẩm"

resp = client.images.edit(
    model="gpt-image-2",
    image=open("product.png", "rb"),
    prompt="Thay nền thành cảnh hoàng hôn bên bờ biển",
)
print(resp.data[0].url or resp.data[0].b64_json[:50])

Điểm cần lưu ý khi sử dụng

• Khi nhập nhiều ảnh (như ảnh sản phẩm + ảnh tham chiếu phong cách), hãy truyền nhiều trường image theo thứ tự và mô tả vai trò của từng ảnh trong prompt;
• Chỉnh sửa cũng tính phí theo mỗi lần, tỷ lệ khung hình/độ phân giải vẫn được kiểm soát bởi hậu tố của tên mô hình;
• Nếu muốn giữ tính nhất quán của nhân vật/sản phẩm, hãy nêu rõ trong prompt “giữ nguyên chủ thể” và ưu tiên dùng đầu ra có độ phân giải gần với ảnh gốc;
• Chiến lược timeout và retry giống như Lưu ý khi gọi ảnh。