Seedream 5.0 Pro

Seedream 5.0 Pro는 ByteDance의 이미지 모델입니다. 요청 한 번으로 프롬프트 또는 프롬프트와 참조 이미지 최대 10장으로 이미지 한 장을 만들거나, 이미지 한 장을 배경 베이스 이미지와 최대 16개의 투명 레이어로 분리합니다. 요청을 보내고 반환된 태스크 ID를 보관한 뒤 완성된 이미지를 태스크에서 읽어 오세요. 참조 이미지는 URL로 전달합니다.

모델 ID

현재 가격은 모델 페이지에서 확인하세요.

간단한 예제

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
  }'

엔드포인트

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

응답은 완성된 이미지가 아니라 태스크({"id": "task_...", "status": "processing"})입니다. 결과는 GET /v1/tasks/{task_id}를 폴링해서 받으세요. API 키는 서버 측 코드에 보관하세요. 참조 이미지와 레이어 분리는 같은 요청의 image로 전달합니다. 이 모델에서는 /v1/images/edits를 사용하지 않으며, 호출하면 400을 반환합니다.

파라미터

이 목록에 없는 필드는 요청을 전달하기 전에 삭제되며, 오류를 일으키거나 출력에 영향을 주지 않습니다. n, stream, seed, response_format 및 순차 생성은 사용할 수 없습니다. callback_url은 사용할 수 없으니 태스크를 폴링하세요.

출력 크기

해상도 단계는 이미지 규모를, 프롬프트는 화면 형태를 정합니다. prompt에 화면비(예: "16:9 가로 이미지")를 지정하면 모델이 프레임을 선택합니다:

고정 프레임에는 해상도 단계 대신 정확한 픽셀 크기를 보내세요. 1K와 1.5K는 비용이 같으며, 2K와 261만 픽셀을 초과하는 크기는 더 높은 요금입니다(과금에 영향을 주는 요소 참고).

참조 이미지

편집하려면 이미지 한 장, 조합하려면 2–10장을 전달하고 prompt에 유지할 부분과 바꿀 부분을 설명하세요. "이미지 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"
}

레이어 분리

layer_decomposition: true와 함께 이미지 한 장을 보내세요. 태스크는 배경 베이스 이미지를 먼저 반환하고, 이어서 각 레이어를 투명 PNG로 반환합니다.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

각 레이어에는 z_index(배경 베이스 이미지는 0이며, 숫자가 클수록 위에 놓임), name, description, bounding_box가 포함됩니다. bounding_box.absolute는 배경 베이스 이미지의 픽셀 단위로 표시한 [left, top, right, bottom]입니다. bounding_box.normalized는 같은 상자를 배경 베이스 이미지의 너비와 높이 각각의 천분의 일 단위로 나타냅니다. 이미지를 다시 구성하려면 각 레이어를 경계 상자 크기에 맞추고, z_index 오름차순으로 배경 베이스 이미지 위에 배치하세요.

size: "auto"이면 배경 베이스 이미지와 각 레이어는 입력 이미지 안에서의 크기를 유지합니다. 입력은 PNG 또는 JPEG여야 하며 총 픽셀 수(가로 × 세로)는 262,144(512 × 512)에서 36,000,000(6000 × 6000) 사이여야 합니다.

투명 배경

알파 채널이 있는 PNG 한 장을 background: "transparent"와 함께 보내면 배경이 투명한 PNG를 받습니다:

{
  "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"
}

미디어 입력

각 참조 이미지는 공개 HTTP(S) URL로 전달합니다. Base64 data URI는 받지 않습니다. 파일을 자체 스토리지에 업로드하고 그 URL을 전달하세요. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF를 지원하며, 이미지당 최대 30 MB, 화면비 1:16~16:1, 너비와 높이 모두 14픽셀 초과, 총 픽셀 수 최대 36,000,000이어야 합니다. 레이어 분리는 PNG 또는 JPEG만 받습니다.

과금에 영향을 주는 요소

현재 요율은 모델 가격 섹션에서 확인하세요. Seedream 5.0 Pro는 용도와 픽셀 수에 따른 요금 단계에 따라 출력 이미지당 과금되며, 첫 장 이후 참조 이미지마다 추가 요금이 붙습니다:

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

• 낮은 요금 단계는 261만 픽셀 이하(1.5K 이하)입니다. 이를 초과하면 높은 요금 단계가 적용됩니다.
• 레이어 분리는 배경 베이스 이미지와 모든 레이어에 과금합니다. 요청 전체에 동일한 요금 단계를 적용하며, 반환된 모든 이미지가 261만 픽셀 이내일 때만 낮은 요금이 적용됩니다.
• 태스크 접수 시 예약되는 금액은 최대 결과를 기준으로 합니다. 일반 생성은 요청한 요금 단계의 이미지 한 장, 레이어 분리는 17장입니다(auto는 높은 요금 단계로 계산). 이후 실제 반환된 이미지에 대해 과금하고 차액은 해제합니다.

최종 과금액은 계정의 사용 내역에서 확인하세요. 실패한 태스크는 과금되지 않습니다.

출력 스키마

제출하면 태스크가 반환됩니다:

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

태스크 조회

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

status가 completed 또는 failed가 될 때까지 10~20초마다 폴링하세요. 폴링 중 네트워크 타임아웃이 났다고 생성이 실패한 것은 아닙니다. 태스크 ID를 보관하고 다시 확인하세요. 진행 상황을 보려고 태스크를 새로 만들지 마세요.

완료된 태스크

{
  "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 }
  }
}

레이어 분리 태스크는 배경 베이스 이미지에 이어 각 레이어를 나열합니다:

{
  "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] }
    }
  ]
}

저희 테스트에서 1K 이미지는 약 35~55초, 배경 베이스 이미지와 레이어 13개를 반환한 1K 레이어 분리는 약 140초가 걸렸습니다.

오류

태스크가 생성되기 전에 거부된 요청은 HTTP 오류와 error 객체를 반환하며 과금되지 않습니다. 접수된 뒤 실패한 태스크는 조회 시 HTTP 200과 함께 status: "failed" 및 error 객체를 반환합니다.

코드, HTTP 상태, 재시도 지침은 공통 오류 카탈로그를 참고하세요.

{
  "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."
  }
}

제출 자체가 타임아웃된 경우에는 다시 보내기 전에 태스크 목록을 확인하세요. 첫 번째 요청이 이미 접수되었을 수 있습니다.

팁

• 1K 또는 1.5K로 시작해 시안을 만드세요. 1.5K와 1K는 비용이 같습니다.
• 해상도 단계를 사용하면 프롬프트에 화면 형태를 지정하고, 고정 레이아웃에는 정확한 픽셀 크기를 보내세요.
• 참조 이미지가 여러 장이면 각 이미지에서 무엇을 가져올지 설명하고 순서로 지칭하세요.
• 표시 없는 이미지가 필요하면 watermark: false로 설정하세요. 기본값은 표시를 추가합니다.
• 레이어 분리에서는 레이어 수를 줄이려면 나눌 요소를 나열하세요.

관련 자료

• Seedream 5.0 Pro Playground와 가격
• OpenAPI 다운로드
• 복사 가능한 Markdown