API tham khảo

Chỉnh sửa ảnh gpt-image-2

Chỉnh sửa ảnh có sẵn bằng gpt-image-2 qua multipart/form-data, phản hồi trả về ảnh dạng base64.

Gửi kèm một ảnh gốc và mô tả thay đổi để `gpt-image-2` chỉnh sửa. Endpoint này nhận `multipart/form-data`, không phải JSON.

Endpoint

POST
POST https://cheapkeyai.shop/v1/images/edits

Yêu cầu

TênVị tríBắt buộcMô tả
Authorizationheader`Bearer sk-your-api-key-here`
Content-Typeheader`multipart/form-data`
modelform`gpt-image-2`
imageformFile ảnh gốc cần sửa
promptformMô tả nội dung muốn sửa thành
maskformKhôngFile mask, chỉ vùng cần sửa
sizeformKhôngKích thước ảnh, ví dụ `1024x1024`
nformKhôngSố ảnh cần tạo, mặc định `1`

Ví dụ

cURL
curl https://cheapkeyai.shop/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -F model="gpt-image-2" \
  -F image="@input.png" \
  -F prompt="Một chú heo con đáng yêu" \
  -F size="1024x1024" \
  -F n=1

Phản hồi 200

Response
{
  "created": 1677652288,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAA..."
    }
  ]
}

Lưu ảnh ra file

Decode base64 → PNG
curl -s https://cheapkeyai.shop/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -F model="gpt-image-2" \
  -F image="@input.png" \
  -F prompt="Một chú heo con đáng yêu" \
  | jq -r '.data[0].b64_json' | base64 -d > edited.png
Python
import base64
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key-here",
    base_url="https://cheapkeyai.shop/v1",
)

result = client.images.edit(
    model="gpt-image-2",
    image=open("input.png", "rb"),
    prompt="Một chú heo con đáng yêu",
    size="1024x1024",
)

with open("edited.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Lỗi 400

Sai tham số hoặc không qua validation
{
  "error": {
    "message": "Invalid request (request id: 20260805120000123456789AbCdEfGh)",
    "type": "new_api_error"
  }
}