Skip to content

Tạo hình ảnh

POST
/v1/images/generations
  • Mô hình sẽ tạo hình ảnh mới dựa trên prompt và/hoặc hình ảnh đầu vào.
  • Hỗ trợ sinh ảnh từ văn bản, chỉnh sửa ảnh, kết hợp nhiều ảnh và các kịch bản khác.
  • Hỗ trợ các mô hình seedream-5.0/4.5/4.0/3.0-t2i và seededit-3.0-i2i.

Authorizations

bearer
Type
HTTP (bearer)

Request Body

application/json
object
  • Hỗ trợ: văn bản sang hình ảnh
    • doubao-seedream-3-0-t2i-250415
  • Hỗ trợ: chỉnh sửa hình ảnh
    • doubao-seededit-3-0-i2i-250628
  • Hỗ trợ: văn bản sang hình ảnh, hình ảnh sang hình ảnh
    • doubao-seedream-5-0-260128
    • doubao-seedream-4-5-251128
    • doubao-seedream-4-0-250828

Câu lệnh dùng để tạo hình ảnh.

Chỉ định định dạng trả về của hình ảnh được tạo. Hỗ trợ hai cách trả về sau:

  • url: Trả về liên kết tải xuống hình ảnh; liên kết có hiệu lực trong 24 giờ sau khi tạo hình ảnh, vui lòng tải xuống kịp thời.
  • b64_json: Trả về dữ liệu hình ảnh ở định dạng JSON chuỗi mã hóa Base64.

Mặc định: url

string

Chỉ doubao-seedream-3.0-t2i/seededit-3.0-i2i hỗ trợ tham số này
Seed ngẫu nhiên, dùng để kiểm soát tính ngẫu nhiên của nội dung do mô hình tạo. Phạm vi giá trị: [-1, 2147483647].
Lưu ý:

  • Với cùng một yêu cầu, nếu mô hình nhận được các giá trị seed khác nhau, như: không chỉ định seed hoặc đặt seed thành -1 (sử dụng số ngẫu nhiên thay thế), hoặc thay đổi thủ công giá trị seed, sẽ tạo ra kết quả khác nhau.
  • Với cùng một yêu cầu, nếu mô hình nhận được các giá trị seed giống nhau, sẽ tạo ra kết quả tương tự, nhưng không đảm bảo hoàn toàn nhất trí.

Mức độ nhất trí giữa kết quả đầu ra của mô hình và prompt, mức độ tự do trong tạo hình ảnh, cũng được gọi là trọng số văn bản; giá trị càng lớn, mức độ tự do của mô hình càng nhỏ, độ liên quan với câu lệnh đầu vào của người dùng càng cao. Phạm vi giá trị: [1, 10].

  • doubao-seedream-3.0-t2i mặc định 2.5
  • doubao-seededit-3.0-i2i mặc định 5.5
  • doubao-seedream-5.0-lite/4.5/4.0 không hỗ trợ

Có thêm watermark vào hình ảnh được tạo hay không.

  • false: Không thêm watermark.
  • true: Thêm watermark "AI tạo" ở góc phải dưới của hình ảnh.

Mặc định: true

string |array

Thông tin hình ảnh đầu vào, hỗ trợ URL hoặc mã hóa Base64.

  • URL hình ảnh: Vui lòng đảm bảo URL hình ảnh có thể truy cập được.
  • Mã hóa Base64: Vui lòng tuân theo định dạng này: data:image/<định dạng>;base64,<mã Base64>. Lưu ý: <định dạng> <định dạng> phải viết thường, ví dụ: data:image/png;base64,<base64_image>.

Chỉ doubao-seedream-5.0-lite/4.5/4.0 hỗ trợ tham số này
Điều khiển việc bật hoặc tắt chức năng tạo nhóm ảnh; dỵa trên nội dung bạn nhập, tạo một nhóm hình ảnh có nội dung liên quan.

  • auto: Chế độ tự động, mô hình sẽ tự phán đoán có hay không trả về nhóm ảnh và số lượng ảnh bao gồm dỵa trên câu lệnh do người dùng cung cấp.
  • disabled: Tắt chức năng tạo nhóm ảnh, mô hình chỉ tạo một ảnh.

Mặc định: disabled

object

Chỉ doubao-seedream-5.0-lite/4.5/4.0 hỗ trợ tham số này
Cấu hình chức năng tạo nhóm ảnh. Chỉ có tác dụng khi sequential_image_generation là auto.

Chỉ doubao-seedream-5.0 hỗ trợ tham số này
Chỉ định định dạng tệp của hình ảnh được tạo. Giá trị khả dụng:

  • png
  • jpeg

Mặc định: jpeg

Responses

Trả về dữ liệu hình ảnh đã tạo thành công

application/json
object
object[]
Required

Playground

Authorization
Body

Samples