Tạo hình ảnh

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

POST/v1/images/generations

Tạo một hoặc nhiều hình ảnh từ prompt văn bản. Bạn có thể mô tả chủ thể, bối cảnh, bố cục, góc nhìn, phong cách nghệ thuật và không khí tổng thể trong prompt, rồi điều chỉnh kết quả bằng kích thước, chất lượng và định dạng trả về mà mô hình hỗ trợ.

Phạm vi mô hình khả dụng và các giới hạn cụ thể của tham số như n, quality, size, style phụ thuộc vào mô hình đã chọn. Hãy sử dụng ID mô hình hỗ trợ tạo 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

application/json

Tham số yêu cầu tạo hình ảnh.

Định nghĩa kiểu TypeScript

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

model?string

ID mô hình tạo hình ảnh cần sử dụng. Chọn mô hình hỗ trợ tạo hình ảnh và khả dụng với API Key hiện tại; các tham số và giới hạn được hỗ trợ có thể khác nhau giữa các mô hình.

Độ dài1 <= length

prompt*string

Mô tả bằng văn bản về hình ảnh muốn tạo. Nên nêu rõ chủ thể, các yếu tố thị giác chính, bố cục, góc nhìn, phong cách nghệ thuật và không khí.

DALL·E 2 nhận tối đa 1.000 ký tự, DALL·E 3 nhận tối đa 4.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ế. Nếu tạo hình ảnh thất bại, hãy kiểm tra cả việc prompt có tuân thủ chính sách nội dung hay không.

Độ dài1 <= length

n?integer|null

Số hình ảnh cần tạo, từ 1 đến 10. DALL·E 3 chỉ hỗ trợ n=1; các mô hình khác có trả về nhiều hình ảnh hay không phụ thuộc vào khả năng thực tế.

Phạm vi1 <= value <= 10

Giá trị mặc định1

quality?string

Chất lượng hình ảnh. hd có thể tạo hình ảnh chi tiết và nhất quán hơn, chỉ áp dụng cho DALL·E 3; các mô hình khác có thể sử dụng giá trị khác.

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

Giá trị được phép

"standard"
"hd"

response_format?string|null

Định dạng trả về hình ảnh. url trả về URL hình ảnh tạm thời, 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. DALL·E 2 hỗ trợ 256x256, 512x512, 1024x1024; DALL·E 3 hỗ trợ 1024x1024, 1792x1024, 1024x1792.

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

Giá trị được phép

"256x256"
"512x512"
"1024x1024"
"1792x1024"
"1024x1792"
null

style?string|null

Phong cách hình ảnh. vivid thiên về hiệu ứng siêu thực và kịch tính, còn natural thiên về vẻ tự nhiên, chân thực. Tham số này chỉ áp dụng cho DALL·E 3.

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

Giá trị được phép

"vivid"
"natural"
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/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Một chú rái cá biển đáng yêu đang chơi đùa trong làn nước trong vắt, ánh sáng tự nhiên dịu nhẹ, chi tiết sắc nét",    "n": 1,    "size": "1024x1024"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image.png",
      "revised_prompt": "Một chú rái cá biển đáng yêu đang chơi đùa trong làn nước trong vắt, với đôi mắt tròn và bộ lông mềm mại."
    }
  ]
}

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`