Tạo / chỉnh sửa ảnh

POST/v1/images/generations

Tạo ảnh từ lời nhắc hoặc truyền ảnh tham chiếu qua image trong cùng yêu cầu JSON để chỉnh sửa.

Xác thực

bearerAuth

Xác thựcBearer <token>

Dùng khóa API của nền tảng.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

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

model*string

ID mô hình trên nền tảng.

prompt?string

Chỉ dẫn tạo hoặc chỉnh sửa ảnh. Chỉ được bỏ qua trong chế độ tách lớp.

Độ dài1 <= length

image?|array<>

Ảnh tham chiếu. Bỏ qua để tạo từ văn bản. Mỗi ảnh không quá 30 MB. Xem giới hạn số ảnh ở trang khác biệt mô hình. Tách lớp chỉ nhận một ảnh.

size?string

Mức phân giải hoặc WIDTHxHEIGHT. Xem giá trị và mặc định ở trang khác biệt mô hình.

optimize_prompt_options?

output_format?string

Định dạng tệp. Khi tách lớp, chỉ điều khiển ảnh nền. Các lớp luôn là PNG.

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

Giá trị được phép

"png"
"jpeg"

background?string

Chế độ trong suốt chỉ dùng cho một ảnh đầu vào có kênh alpha, đầu ra PNG.

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

Giá trị được phép

"opaque"
"transparent"

response_format?string

Trả URL ảnh hoặc dữ liệu Base64.

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

Giá trị được phép

"url"
"b64_json"

watermark?boolean

Có thêm dấu chìm ảnh do AI tạo hay không.

Giá trị mặc địnhtrue

layer_decomposition?boolean

Tách một ảnh thành ảnh nền và các lớp riêng. Chỉ một số mô hình hỗ trợ.

Giá trị mặc địnhfalse

sequential_image_generation?string

Chế độ chuỗi ảnh. auto để mô hình quyết định có tạo chuỗi hay không.

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

Giá trị được phép

"disabled"
"auto"

sequential_image_generation_options?

stream?boolean

Trả từng ảnh đã tạo. Chỉ một số mô hình hỗ trợ.

Giá trị mặc địnhfalse

tools?array<>

Công cụ tìm kiếm web. Chỉ một số mô hình hỗ trợ.

Nội dung phản hồi

`application/json`

type*string

model?string

ID mô hình thực tế sử dụng.

created?integer

Dấu thời gian Unix tính bằng giây.

Phạm vi0 <= value

image_index*integer

Chỉ số ảnh bắt đầu từ 0.

Phạm vi0 <= value

url?string

URL tải tạm thời. Lưu ảnh trong vòng 24 giờ.

Định dạnguri

b64_json?string

Dữ liệu ảnh Base64.

size?string

Kích thước thực tế theo WIDTHxHEIGHT.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Tạo ảnh chụp chiếc cốc trắng trên bàn gỗ, với ánh sáng dịu từ cửa sổ bên trái."
  }'

{
  "created": 1793980674,
  "data": [
    {
      "url": "https://example.com/result.jpeg"
    }
  ]
}

Thay URL của ví dụ sửa ảnh bằng ảnh vừa tạo ở bước trước. Với Base64, thay BASE64_BYTES bằng dữ liệu thực và giữ tiền tố Data URL đúng định dạng ảnh.

API tạo ảnh VolcengineCác trường API, phản hồi và hướng dẫn tính năng.

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

Sự kiện phản hồi dạng luồng

`application/json`

`application/json`

`application/json`