APIMaster.ai

API Seedream 5.5 — tạo, RGBA, chỉnh sửa, lớp và OCR văn bản định dạng phong phú

Tham số yêu cầu đầy đủ, ràng buộc hình ảnh, tái tạo lớp, OCR văn bản định dạng phong phú và định giá hình ảnh dựa trên mức sử dụng cho doubao-seedream-5-5-261028.

Seedream 5.5

Sử dụng mô hình doubao-seedream-5-5-261028 với POST https://apimaster.ai/v1/images/generations, nội dung JSON và Authorization: Bearer YOUR_API_KEY. Tạo khóa APIMaster của bạn trong bảng điều khiển.

Hỗ trợ text-to-image, chỉnh sửa với tối đa mười tham chiếu, chỉnh sửa liên tiếp, đầu ra RGBA trong suốt gốc, phân tách lớp và OCR văn bản định dạng phong phú. Tạo thông thường trả về một hình ảnh. Phân tách trả về một nền và các lớp riêng biệt. Truyền trực tuyến, tạo ảnh tuần tự và tìm kiếm web không được hỗ trợ. Sử dụng điểm cuối đồng bộ; cho phép ít nhất 300 giây trước khi hết thời gian chờ của máy khách và tránh gửi lại mù quáng.

Định giá cơ sở chính thức

Đã đối chiếu với bảng giá Volcengine vào ngày 2026-11-13. Tỷ giá quy đổi được cấu hình là 7 CNY cho mỗi USD.

Mục CNY mỗi hình ảnh Giá cơ sở USD ước tính
Mọi tham chiếu đầu vào, kể cả tham chiếu đầu tiên 0.05 0.00714286
Đầu ra có chiều rộng × chiều cao ≤ 2,610,000 pixel 0.13 0.01857143
Đầu ra trên 2,610,000 pixel 0.23 0.03285714

Tạo và phân tách sử dụng cùng mức giá đầu ra. Tính phí từng nền/lớp riêng biệt bằng data[].size thực tế của nó; cạnh dài nhất không quyết định bậc. 2048x1024 thuộc bậc thấp hơn. Hai đầu vào cộng một đầu ra bậc cao tốn CNY 0.33 trước hệ số tài khoản/kênh. Khác với Seedream 5.0 Pro, tham chiếu đầu tiên không miễn phí. Phí tài khoản thực tế bao gồm hệ số nhóm kênh/người dùng áp dụng và làm tròn hạn mức số nguyên. Xem thẻ mô hình trực tiếp và nhật ký sử dụng.

Tạo ảnh từ văn bản

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Tham số

Trường Kiểu / mặc định Quy tắc
model chuỗi bắt buộc doubao-seedream-5-5-261028.
prompt chuỗi Bắt buộc để tạo; tùy chọn để phân tách. Mô tả nội dung, phong cách, tỷ lệ khung hình, văn bản hoặc vị trí chỉnh sửa. Hướng dẫn viết chính thức khuyến nghị ≤300 ký tự tiếng Trung hoặc ≤600 từ tiếng Anh; đây là hướng dẫn chứ không phải giới hạn byte.
image chuỗi hoặc chuỗi[] URL công khai hoặc data:image/png;base64,.... Tối đa mười tham chiếu tạo; chính xác một đầu vào để phân tách. Đường dẫn hệ thống tệp cục bộ không hoạt động.
size chuỗi Tạo mặc định là 2K; 1K, 1.5K, 2K hoặc chính xác WIDTHxHEIGHT. Phân tách mặc định là auto, chỉ chấp nhận auto và ba bậc này.
output_format chuỗi, png png hoặc jpeg. Đối với phân tách, điều này chỉ kiểm soát nền; các lớp luôn là PNG.
background chuỗi, auto auto, transparent hoặc opaque, chỉ cho tạo. Đầu ra trong suốt yêu cầu PNG; bỏ qua trường này hoàn toàn đối với phân tách.
response_format chuỗi, url url hoặc b64_json. Đọc trường khớp trong mỗi mục data[].
watermark boolean, true Đặt false để bỏ qua hình mờ tạo AI hiển thị.
optimize_prompt_options object Chỉ {"mode":"standard"} được hỗ trợ bởi 5.5; fast không được hỗ trợ.
layer_decomposition boolean, false Bật phân tách một hình ảnh PNG/JPEG.
layer_decomposition_options object Tùy chọn phân tách bên dưới.
layer_decomposition_options.max_images integer, 30 2–100, bao gồm nền. Mức tối đa, không phải số lượng được đảm bảo.
layer_decomposition_options.text_recognition boolean, false Yêu cầu OCR văn bản định dạng phong phú cho các lớp văn bản thông thường.
safety_identifier chuỗi Mã định danh người dùng tiếng Anh ổn định, tối đa 64 ký tự; sử dụng hàm băm thay vì thông tin liên hệ cá nhân.

Không sử dụng resolution, quality, n hoặc seed của mô hình khác để điều khiển mô hình này. Chúng không được liệt kê là các điều khiển tạo tương ứng của nó trong API chính thức. Đặt giới hạn phân tách bằng layer_decomposition_options.max_images.

Kích thước và hạn chế đầu vào

Đối với tạo thông thường, chọn một bậc (1K, 1.5K, 2K) và mô tả tỷ lệ khung hình trong lời nhắc, hoặc cung cấp kích thước chính xác. Diện tích đầu ra chính xác phải là 921,600–4,624,220 pixel, với tỷ lệ khung hình 1:16–16:1, thỏa mãn cả hai ràng buộc. 2880x1440 hợp lệ; 512x512 quá nhỏ. Không có bậc 4K.

Phân tách không chấp nhận kích thước chính xác. Với auto, kích thước nền/lớp trong phạm vi được hỗ trợ giữ nguyên kích thước ban đầu nếu có thể; các mục nhỏ hơn/lớn hơn được chia tỷ lệ về phía 1K/2K trong khi vẫn giữ tỷ lệ khung hình. Các lớp được trả về có thể chiếm các bậc thanh toán khác nhau.

Hạn chế đầu vào Tạo/chỉnh sửa Phân tách
Số lượng Tối đa 10 Chính xác 1
Định dạng JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF PNG, JPEG
Kích thước tệp mỗi hình ảnh ≤30 MB ≤30 MB
Diện tích pixel 196–36,000,000; cả hai cạnh >14 px 262,144–36,000,000
Tỷ lệ khung hình 1:16–16:1 1:16–16:1

Sử dụng loại MIME chữ thường trong URL dữ liệu. URL đầu vào từ xa phải truy cập được đối với dịch vụ.

Chỉnh sửa và hình ảnh trong suốt

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Đối với một đầu vào, image có thể là một chuỗi. Đối với chỉnh sửa liên tiếp, chuyển rõ ràng đầu ra trước đó làm đầu vào tiếp theo: đây không phải là cuộc trò chuyện có trạng thái và mỗi yêu cầu được tính phí riêng. Mô tả tọa độ/hộp/mũi tên trong lời nhắc hoặc vẽ dấu trên tham chiếu; không có tham số định vị mask riêng được ghi lại cho giao diện này.

Đối với tạo trong suốt gốc, bỏ qua image nếu không cần thiết và đặt background: "transparent", output_format: "png", với lời nhắc như “a translucent blue glass butterfly, isolated asset, transparent background”. Chỉnh sửa có thể sử dụng tối đa mười tham chiếu; chúng không cần đã có kênh alpha. transparent cộng jpeg là không hợp lệ. background của phản hồi mô tả độ trong suốt thực tế (transparent hoặc opaque).

Phân tách và OCR văn bản định dạng phong phú

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Hỗ trợ một nền cộng tối đa 99 lớp. max_images: 4 bao gồm nền. Bỏ qua background; mọi lớp là PNG trong suốt. Lỗi một lớp riêng lẻ làm toàn bộ yêu cầu thất bại thay vì trả về thành công một phần.

Đọc tất cả các mục data[]:

  • url/b64_json, size và output_format xác định thành phần và kích thước thực tế của nó; background có sẵn khi áp dụng.
  • z_index: 0 xác định nền; các chỉ số lớn hơn xuất hiện phía trên các chỉ số nhỏ hơn.
  • name và description mô tả lớp.
  • bounding_box.absolute là [left,top,right,bottom] tính bằng pixel nền đầu ra. Thay đổi kích thước một lớp thành (right-left) × (bottom-top) và đặt nó tại (left,top); kích thước tệp lớp có thể khác với dấu chân canvas của nó.
  • bounding_box.normalized sử dụng tọa độ 0–1000. Nhân tọa độ ngang/dọc với chiều rộng/chiều cao canvas đích và chia cho 1000.
  • text_recognition chỉ xuất hiện khi được yêu cầu và lớp chứa văn bản thông thường được nhận dạng. Chữ viết tay, chữ nghệ thuật và các lớp không phải văn bản có thể bỏ qua nó.

OCR chứa text và lines[]; mỗi dòng có bounding_box riêng và runs[] được định kiểu. Mỗi đoạn có text và style, có thể chứa similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow và translucent. Đây là các giải thích thị giác gần đúng, không phải thuộc tính thiết kế gốc chính xác; nhận dạng phông chữ có thể trả về unknown.

Phản hồi, lưu trữ và lỗi

Phản hồi chứa created, model, data[], usage.input_images và usage.generated_images. Số lượng được tạo bao gồm nền và các lớp. Bảo toàn siêu dữ liệu phản hồi đầy đủ. URL tải xuống của nhà cung cấp gốc hết hạn sau 24 giờ; tải xuống/lưu trữ tài sản của bạn ngay lập tức.

Sửa kích thước không hợp lệ, số lượng tham chiếu hoặc tùy chọn trong suốt không tương thích trước khi thử lại. Xử lý xác thực, quyền, kiểm duyệt, giới hạn tốc độ và lỗi thượng nguồn riêng biệt; không bao giờ diễn giải lỗi là tạo thành công. Giới hạn IPM đếm hình ảnh được tạo trên mỗi tài khoản/phiên bản mô hình; phân tách dự trữ max_images và trả lại dung lượng chưa dùng sau khi hoàn thành, trong khi thanh toán sử dụng hình ảnh thực tế được tạo.

Nguồn chính thức: Seedream 5.5, API tạo hình ảnh, định giá. Tham số đã được kiểm tra ngày 2026-11-13.