Chỉnh sửa hình ảnh

Tạo kết quả chỉnh sửa từ một hoặc nhiều hình ảnh đầu vào và prompt văn bản; cũng có thể dùng mặt nạ để chỉ định vùng cần thay đổi.

POST/v1/images/edits

Tạo hình ảnh đã chỉnh sửa từ một hoặc nhiều hình ảnh đầu vào và prompt văn bản. Khi cung cấp mặt nạ, vùng trong suốt của mặt nạ chỉ vị trí cần chỉnh sửa; khi chỉnh sửa nhiều hình ảnh, mặt nạ áp dụng cho hình ảnh đầu tiên.

Loại, kích thước, số lượng tệp đầu vào, quy tắc mặt nạ và tùy chọn chất lượng, kích thước phụ thuộc vào mô hình đã chọn. Hãy sử dụng ID mô hình hỗ trợ chỉnh sửa hình ảnh và khả dụng với API Key hiện tại.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

multipart/form-data

Gửi hình ảnh, prompt và mặt nạ tùy chọn bằng Multipart. Phía máy khách nên để thư viện gửi yêu cầu tự tạo boundary của Content-Type.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

image*|array<>

Một hoặc nhiều hình ảnh cần chỉnh sửa. DALL·E 2 nhận PNG hình vuông dưới 4 MB; nếu không cung cấp mask, hình ảnh phải có vùng trong suốt. GPT-Image-1 nhận nhiều hình ảnh PNG, WEBP hoặc JPG, mỗi hình dưới 25 MB.

Định dạng, kích thước và số lượng tệp thực tế được hỗ trợ phụ thuộc vào mô hình đã chọn.

prompt*string

Kết quả chỉnh sửa mong muốn. DALL·E 2 nhận tối đa 1.000 ký tự, GPT-Image-1 nhận tối đa 32.000 ký tự; giới hạn của các mô hình khác phụ thuộc vào khả năng thực tế.

Độ dài1 <= length

mask?file

Hình ảnh mặt nạ tùy chọn. Vùng hoàn toàn trong suốt chỉ vị trí cần chỉnh sửa. Mặt nạ phải là PNG dưới 4 MB và có cùng kích thước với hình ảnh đầu vào; khi chỉnh sửa nhiều hình ảnh, mặt nạ áp dụng cho hình ảnh đầu tiên.

Định dạngbinary

model*string

ID mô hình chỉnh sửa hình ảnh cần sử dụng. Chọn mô hình hỗ trợ chỉnh sửa hình ảnh và khả dụng với API Key hiện tại.

Độ dài1 <= length

n?integer|null

Số hình ảnh cần trả về, từ 1 đến 10; số lượng thực tế được hỗ trợ phụ thuộc vào mô hình đã chọn.

Phạm vi1 <= value <= 10

Giá trị mặc định1

quality?string|null

Chất lượng hình ảnh. GPT-Image-1 hỗ trợ high, medium, low; DALL·E 2 dùng standard; giá trị mặc định là auto.

Giá trị mặc định"auto"

Giá trị được phép

"auto"
"high"
"medium"
"low"
"standard"
null

response_format?string|null

Định dạng trả về hình ảnh. url trả về URL hình ảnh có hiệu lực trong 60 phút sau khi tạo; b64_json trả về dữ liệu hình ảnh mã hóa Base64.

Giá trị mặc định"url"

Giá trị được phép

"url"
"b64_json"
null

size?string|null

Kích thước hình ảnh. GPT-Image-1 hỗ trợ 1024x1024, 1536x1024, 1024x1536 và auto; DALL·E 2 hỗ trợ 256x256, 512x512, 1024x1024.

Giá trị mặc định"1024x1024"

Giá trị được phép

"256x256"
"512x512"
"1024x1024"
"1536x1024"
"1024x1536"
"auto"
null

user?string

Định danh duy nhất đại diện cho người dùng cuối, dùng để giám sát và phát hiện hành vi lạm dụng.

Độ dài1 <= length

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/images/edits" \  -F model="MODEL_ID" \  -F image="otter.png" \  -F mask="mask.png" \  -F prompt="Một chú rái cá biển đáng yêu đội mũ beret" \  -F n="1" \  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/edited-image-1.png"
    },
    {
      "url": "https://example.com/edited-image-2.png"
    }
  ]
}

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`