Seedream 5.5

Seedream 5.5 là mô hình ảnh của ByteDance. Một yêu cầu tạo một ảnh từ prompt, từ prompt cùng tối đa 10 ảnh tham chiếu hoặc tách một ảnh thành ảnh nền và các lớp trong suốt, có thể kèm phần chữ được nhận dạng từ từng lớp văn bản. Hãy gửi yêu cầu, giữ ID tác vụ được trả về, rồi đọc ảnh hoàn chỉnh từ tác vụ. Ảnh tham chiếu được truyền vào dưới dạng URL.

ID mô hình

Xem trang mô hình để biết giá hiện tại.

Ví dụ nhanh

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
    "size": "1K"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/images/generations

Phản hồi là một tác vụ ({"id": "task_...", "status": "processing"}), không phải ảnh hoàn chỉnh. Hãy truy vấn GET /v1/tasks/{task_id} để lấy kết quả. Hãy giữ khóa API trong code phía máy chủ. Ảnh tham chiếu và tách lớp được truyền trong cùng yêu cầu qua image; mô hình này không dùng /v1/images/edits và endpoint đó trả về 400.

Tham số

Các trường ngoài danh sách này bị loại bỏ trước khi chuyển tiếp yêu cầu; chúng không gây lỗi và không thay đổi đầu ra. Không hỗ trợ n, stream, seed và response_format: mỗi yêu cầu trả về một ảnh, hoặc tối đa max_images ảnh khi dùng layer_decomposition. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.

Kích thước đầu ra

Không có mức kích thước 3K hay 4K và không hỗ trợ dạng tỷ lệ khung hình: với khung hình 16:9 cố định ở 2K, gửi 2560x1440. 1K và 1.5K có cùng giá; 2K và mọi kích thước trên 2,61 triệu pixel có giá cao hơn (xem Các yếu tố chi phí).

Ảnh tham chiếu

Truyền một ảnh để chỉnh sửa hoặc nhiều ảnh để kết hợp, rồi nêu trong prompt những gì cần giữ và cần thay đổi. Nhắc đến ảnh theo thứ tự (“áo khoác trong ảnh 1”).

{
  "model": "seedream-5-5",
  "prompt": "Turn this scene into a snowy winter night with warm light from the lighthouse windows, keep the composition",
  "image": "https://example.com/lighthouse.jpg",
  "size": "2560x1440"
}

Nền trong suốt

Đặt background: "transparent" để có PNG với nền trong suốt, chỉ từ prompt hoặc từ ảnh tham chiếu:

{
  "model": "seedream-5-5",
  "prompt": "A glossy red enamel pin shaped like a cherry, product cutout",
  "background": "transparent",
  "output_format": "png",
  "size": "1K"
}

Tách lớp

Gửi đúng một ảnh với layer_decomposition: true. Tác vụ trả về ảnh nền trước, sau đó là từng lớp dưới dạng PNG trong suốt.

{
  "model": "seedream-5-5",
  "image": "https://example.com/poster.jpg",
  "layer_decomposition": true,
  "size": "1K",
  "layer_decomposition_options": { "max_images": 4, "text_recognition": true }
}

Mỗi lớp có z_index (ảnh nền là 0; số lớn hơn nằm ở trên), background và các trường name, description, bounding_box khi mô hình cung cấp. bounding_box.absolute là [left, top, right, bottom] theo pixel của ảnh nền; bounding_box.normalized là cùng hộp bao đó được quy về thang 0–1000. Các tệp lớp được dựng ở mức kích thước đã chọn nên kích thước pixel có thể khác hộp bao: để ghép lại ảnh, co giãn từng lớp cho vừa hộp bao rồi đặt lên ảnh nền theo thứ tự z_index tăng dần.

Mức kích thước đặt kích thước cho ảnh nền và từng lớp. Với auto, đầu ra theo ảnh đầu vào, được nâng lên tối thiểu 1K hoặc hạ xuống tối đa 2K.

Nhận dạng văn bản

Với layer_decomposition_options.text_recognition: true, lớp chứa chữ in thông thường còn có text_recognition: toàn bộ text (các dòng nối bằng \n) và lines, mỗi dòng có bounding_box riêng và các runs là đoạn văn bản có kiểu trình bày khác nhau. style của mỗi đoạn có similar_font_family, foreground_color (#RRGGBB) và các thuộc tính bold, italic, underline, strikethrough, shadow, translucent. Phông chữ và các thuộc tính này do mô hình ước đoán. Chữ nghệ thuật hoặc viết tay không trả về văn bản, và prompt gửi cùng lần tách có thể khiến văn bản không được trả về, nên hãy coi đây là trường tùy chọn.

Đầu vào media

Mỗi ảnh tham chiếu là một URL HTTP(S) công khai. Không chấp nhận data URI base64: hãy tải tệp lên kho lưu trữ của bạn và truyền URL của nó. Các định dạng được chấp nhận là JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC và HEIF, mỗi tệp tối đa 30 MB và tổng số pixel tối đa 36.000.000. Không hỗ trợ AVIF và JP2; tác vụ không đọc được đầu vào sẽ thất bại và không bị tính phí.

Các yếu tố chi phí

Xem phần giá của mô hình để biết mức giá hiện tại. Seedream 5.5 tính phí mỗi ảnh đầu ra theo bậc giá dựa trên số pixel, cộng thêm phí cho mọi ảnh tham chiếu:

cost = Σ each returned image's price for its own tier + reference images × reference price

• Bậc giá thấp áp dụng cho ảnh tối đa 2,61 triệu pixel (1K và 1.5K); ảnh lớn hơn thuộc bậc giá cao.
• Mọi ảnh tham chiếu đều được tính phí, kể cả ảnh đầu tiên. Tách lớp tính phí một ảnh đầu vào.
• Tách lớp tính phí ảnh nền và từng lớp, mỗi ảnh theo bậc giá ứng với kích thước riêng.
• Số tiền tạm giữ khi tác vụ được tiếp nhận đủ cho kết quả lớn nhất: một ảnh ở bậc giá yêu cầu hoặc max_images ảnh (30 nếu bỏ qua) khi tách lớp, với auto được tính là bậc giá cao. Sau đó, tác vụ được tính phí theo số ảnh thực tế trả về và phần chênh lệch được giải phóng.

Xem khoản phí cuối cùng trong lịch sử sử dụng của tài khoản. Tác vụ thất bại không bị tính phí.

Lược đồ đầu ra

Khi gửi, API trả về tác vụ:

{"id": "task_...", "model": "seedream-5-5", "status": "processing", "created_at": 1794323757}

Lấy thông tin tác vụ

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Hãy truy vấn 10–20 giây một lần cho đến khi status là completed hoặc failed. Hết thời gian chờ do mạng trong lúc truy vấn không có nghĩa là việc tạo ảnh đã thất bại: hãy giữ ID tác vụ và tiếp tục kiểm tra. Đừng tạo tác vụ khác chỉ để xem tiến độ.

Tác vụ hoàn tất

{
  "id": "task_...",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794323757,
  "finished_at": 1794323804,
  "output": {
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.png",
        "size": "1248x832",
        "output_format": "png",
        "background": "opaque"
      }
    ]
  }
}

Tác vụ tách lớp liệt kê ảnh nền trước rồi đến từng lớp. Đây là kết quả tách poster thực tế khi bật nhận dạng văn bản; bên dưới là ảnh nền và lớp đầu tiên trong ba lớp:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.png", "size": "836x1254", "output_format": "png", "background": "opaque", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "1455x721",
      "output_format": "png",
      "background": "transparent",
      "z_index": 1,
      "name": "Dark blue serif main title text with dash decorations",
      "description": "Dark blue serif main title text reading \"BLUE TIDE SESSIONS\", with short horizontal dash decorations on its left and right sides.",
      "bounding_box": { "absolute": [0, 0, 836, 414], "normalized": [0, 0, 1000, 330] },
      "text_recognition": {
        "text": "BLUE TIDE\nSESSIONS",
        "lines": [
          {
            "bounding_box": { "absolute": [146, 69, 694, 196], "normalized": [175, 55, 830, 156] },
            "runs": [
              {
                "text": "BLUE TIDE",
                "style": { "similar_font_family": "HTF Didot", "foreground_color": "#122C4D", "bold": false, "italic": false, "underline": false, "strikethrough": false, "shadow": false, "translucent": false }
              }
            ]
          },
          {
            "bounding_box": { "absolute": [175, 168, 664, 300], "normalized": [209, 134, 794, 239] },
            "runs": [
              {
                "text": "SESSIONS",
                "style": { "similar_font_family": "HTF Didot", "foreground_color": "#122C4D", "bold": false, "italic": false, "underline": false, "strikethrough": false, "shadow": false, "translucent": false }
              }
            ]
          }
        ]
      }
    }
  ]
}

Trong thử nghiệm của chúng tôi, ảnh 1K mất 47 giây, chỉnh sửa ở 2K với một ảnh tham chiếu mất 40 giây, còn tách lớp ở 1K trả về bốn ảnh mất 39 giây. Các lần tách lớn hơn có thể mất vài phút.

Lỗi

Những yêu cầu bị từ chối trước khi tác vụ được tạo sẽ trả về lỗi HTTP kèm đối tượng error và không bị tính phí. Tác vụ thất bại sau khi đã được tiếp nhận sẽ trả về HTTP 200 khi truy vấn, kèm status: "failed" và một đối tượng error.

Hãy xem danh mục lỗi dùng chung để biết mã lỗi, mã trạng thái HTTP và hướng dẫn thử lại.

{
  "id": "task_...",
  "model": "seedream-5-5",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Nếu chính lần gửi bị hết thời gian chờ, hãy kiểm tra các tác vụ của bạn trước khi gửi lại: yêu cầu đầu tiên có thể đã được tiếp nhận.

Mẹo

• Bắt đầu ở 1K hoặc 1.5K để thử các phiên bản; 1.5K có giá bằng 1K.
• Dùng kích thước pixel chính xác để cố định hình dạng, như 2560x1440 cho 16:9 ở 2K.
• Mọi ảnh tham chiếu đều tốn tiền: chỉ gửi những ảnh cần cho việc chỉnh sửa.
• Khi tách lớp, đặt max_images gần số thành phần dự kiến; số tiền tạm giữ thay đổi theo giá trị đó.
• Khi chủ yếu cần văn bản, hãy bỏ prompt trong lần tách có bật text_recognition.

Liên quan

• Seedream 5.5 Playground và bảng giá
• Seedream 5.0 Pro API
• Tải OpenAPI
• Markdown có thể sao chép