Quick Answer
- Call the async image task API with model=doubao-seedream-5-5.
- size accepts 1K/1.5K/2K tiers or explicit WxH pixels within 921,600-4,624,220 total pixels.
- metadata.background=transparent 는 RGBA PNG 를 출력합니다. 레이어 max_images 는 기본 이미지를 포함해 2-100, 기본값은 30 입니다.
Key Parameters
- model | string | required | doubao-seedream-5-5 | - | Use doubao-seedream-5-5 as the exact model id.
- prompt | string | optional | - | - | 일반 생성과 편집에는 필수이며 layer_decomposition=true 일 때는 생략할 수 있습니다.
- size | string | optional | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | 일반 생성은 모델 기본 해상도, 레이어 분해는 auto 입니다. 등급은 비율을 고정하지 않으며 지정 크기는 총 921600-4624220 픽셀이어야 합니다.
- image_urls | string[] | optional | - | 0-10 | image_urls 로 JPEG, PNG, WEBP 참조 이미지 1-10 장을 전달합니다. 로컬 파일은 먼저 업로드한 뒤 반환된 URL 을 사용하세요.
- n | integer | optional | 1 | 1 | 1 을 사용하거나 생략하세요. 일반 출력은 1 장이며 레이어 수를 지정하는 값이 아닙니다.
- layer_decomposition | boolean | optional | false | - | 일반 생성에서는 끄세요. 참조 이미지는 한 장이며 metadata.background 는 생략해야 합니다. 기본 이미지와 투명 PNG 레이어를 반환하고 총수의 상한은 layer_decomposition_options.max_images 로 지정합니다.
- layer_decomposition_options.max_images | integer | optional | 30 | 2-100 | 기본 이미지를 포함한 레이어 분해의 총 출력 상한입니다. 지정한 수를 보장하지 않으며 실제 수는 모델이 결정합니다.
- layer_decomposition_options.text_recognition | boolean | optional | - | - | 레이어 분해의 문자 인식을 제어합니다. 제공자가 반환한 경우에만 작업 결과에 text_recognition 메타데이터가 포함됩니다.
- metadata.output_format | string | optional | - | png | jpeg | 생략하면 상위 서비스 기본 형식을 사용하며 투명 배경은 png 입니다. 분해 시 기본 이미지에만 적용되고 다른 레이어는 항상 PNG 입니다.
- metadata.background | string | optional | - | auto | opaque | transparent | 일반 생성과 편집에서만 사용합니다. layer_decomposition=true 일 때는 opaque 도 생략해야 합니다. transparent 는 RGBA PNG 이며 jpeg 와 함께 사용할 수 없습니다.
- metadata.watermark | boolean | optional | - | - | Set false to disable the visible watermark.
- metadata.response_format | string | optional | url | url | b64_json | Result delivery form; url is recommended.
Common Errors
- 400 invalid_input: trigger=size pixels out of range, more than 10 reference images, or layer_decomposition without exactly one input image.; fix=Validate size, image_urls count, and layer_decomposition input constraints against docs.; retry=Retry only after correcting the payload.
- 429 rate_limit_exceeded: trigger=Request rate, concurrency, or quota hits rate limiting.; fix=Apply exponential backoff, then review request pacing and quota usage.; retry=Use 1s/2s/4s backoff with jitter.
