Tạo biến thể hình ảnh

Có thể điều chỉnh số lượng biến thể, kích thước và định dạng trả về theo khả năng của mô hình.

POST/v1/images/variations

Tạo một hoặc nhiều biến thể thị giác từ một hình ảnh đầu vào. Hình ảnh đầu vào phải đáp ứng yêu cầu về định dạng, dung lượng và kích thước mà mô hình đã chọn hỗ trợ.

Khả năng hỗ trợ biến thể hình ảnh phụ thuộc vào khả năng thực tế của các mô hình 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 nguồn của biến thể 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*file

Hình ảnh làm cơ sở cho biến thể. Sử dụng PNG hình vuông dưới 4 MB; giới hạn tệp thực tế phụ thuộc vào mô hình đã chọn.

Định dạngbinary

model?string

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

Độ dài1 <= length

n?integer|null

Số biến thể 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

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, hỗ trợ 256x256, 512x512 và 1024x1024.

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

Giá trị được phép

"256x256"
"512x512"
"1024x1024"
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/variations" \  -F image="otter.png" \  -F model="MODEL_ID" \  -F n="2" \  -F size="1024x1024"

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

Tạo biến thể hình ảnh

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

401application/json

`application/json`

`application/json`