Seedream 5.0 Pro

Seedream 5.0 Pro 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à tối đa 16 lớp trong suốt. 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-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

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, response_format và tạo ảnh tuần tự. callback_url không được hỗ trợ; hãy truy vấn tác vụ thay thế.

Kích thước đầu ra

Mức kích thước quyết định quy mô ảnh, còn prompt quyết định hình dạng. Nêu tỷ lệ khung hình trong prompt (ví dụ “khung ngang 16:9”) để mô hình chọn khung hình:

Để có khung hình cố định, gửi kích thước pixel chính xác thay vì mức kích thước. 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 2–10 ả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-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

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-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Mỗi lớp có z_index (ảnh nền là 0; số lớn hơn nằm ở trên), name, description và bounding_box. bounding_box.absolute là [left, top, right, bottom] theo pixel của ảnh nền; bounding_box.normalized là cùng hộp bao đó tính theo phần nghìn chiều rộng và chiều cao của ảnh nền. Để 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.

Với size: "auto", ảnh nền và từng lớp giữ nguyên kích thước của chúng trong ảnh đầu vào. Đầu vào phải là PNG hoặc JPEG với tổng số pixel (rộng × cao) từ 262.144 (512 × 512) đến 36.000.000 (6000 × 6000).

Nền trong suốt

Gửi một PNG có kênh alpha với background: "transparent" để nhận PNG có nền trong suốt:

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Đầ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, tỷ lệ từ 1:16 đến 16:1, chiều rộng và chiều cao đều lớn hơn 14 pixel, tổng số pixel tối đa 36.000.000. Tách lớp chỉ nhận PNG hoặc JPEG.

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.0 Pro tính phí mỗi ảnh đầu ra theo trường hợp sử dụng và bậc giá theo số pixel, cộng thêm phí cho mỗi ảnh tham chiếu sau ảnh đầu tiên:

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• Bậc giá thấp áp dụng cho ảnh tối đa 2,61 triệu pixel (1.5K trở xuống); ảnh lớn hơn thuộc bậc giá cao.
• Tách lớp tính phí cả ảnh nền và từng lớp. Toàn bộ yêu cầu dùng một bậc giá: chỉ áp dụng giá thấp khi mọi ảnh được trả về đều không vượt quá 2,61 triệu pixel.
• 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 17 ảnh khi tách lớp (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-0-pro", "status": "processing", "created_at": 1789689600}

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 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-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Tác vụ tách lớp liệt kê ảnh nền trước rồi đến từng lớp:

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

Trong thử nghiệm của chúng tôi, một ảnh 1K mất khoảng 35–55 giây và một lần tách lớp ở 1K trả về ảnh nền cùng 13 lớp mất khoảng 140 giây.

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-0-pro",
  "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.
• Nêu hình dạng trong prompt khi dùng mức kích thước hoặc gửi kích thước pixel chính xác cho bố cục cố định.
• Khi dùng nhiều ảnh tham chiếu, nêu phần cần lấy từ mỗi ảnh và nhắc đến chúng theo thứ tự.
• Đặt watermark: false khi cần ảnh không có dấu; mặc định sẽ thêm dấu.
• Khi tách lớp, liệt kê các thành phần muốn tách để giữ số lớp ít.

Liên quan

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