Seedream 5.5

모델 **doubao-seedream-5-5-261028**를 POST https://apimaster.ai/v1/images/generations, JSON 본문 및 Authorization: Bearer YOUR_API_KEY와 함께 사용하십시오. 콘솔에서 APIMaster 키를 생성하십시오.

텍스트-투-이미지, 최대 10개의 레퍼런스를 사용한 편집, 연속 편집, 네이티브 투명 RGBA 출력, 레이어 분해 및 리치 텍스트 OCR을 지원합니다. 일반 생성은 이미지 한 장을 반환합니다. 분해는 베이스와 개별 레이어를 반환합니다. 스트리밍, 순차 이미지 생성 및 웹 검색은 지원되지 않습니다. 동기 엔드포인트를 사용하고, 클라이언트 타임아웃 전에 최소 300초를 확보하며, 무작정 재요청하지 마십시오.

공식 기본 가격

2026-11-13에 Volcengine 요금을 확인했습니다. 설정된 환율은 1 USD = 7 CNY입니다.

항목	이미지당 CNY	대략적인 USD 기본 가격
첫 번째를 포함한 모든 입력 레퍼런스	0.05	0.00714286
너비 × 높이 ≤ 2,610,000 픽셀인 출력	0.13	0.01857143
2,610,000 픽셀을 초과하는 출력	0.23	0.03285714

생성과 분해는 동일한 출력 요율을 사용합니다. 각 베이스/레이어는 실제 data[].size를 기준으로 개별 청구되며, 가장 긴 변이 등급을 결정하지 않습니다. 2048x1024는 하위 등급에 속합니다. 입력 두 개와 상위 등급 출력 하나의 비용은 계정/채널 배수를 적용하기 전 CNY 0.33입니다. Seedream 5.0 Pro와 달리, 첫 번째 레퍼런스는 무료가 아닙니다. 실제 계정 청구에는 해당 채널/사용자 그룹 계수와 정수 할당량 반올림이 포함됩니다. 실시간 모델 카드와 사용 로그를 참조하십시오.

텍스트-투-이미지

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

파라미터

필드	유형 / 기본값	규칙
model	필수 string	doubao-seedream-5-5-261028.
prompt	string	생성 시 필수, 분해 시 선택 사항입니다. 콘텐츠, 스타일, 화면 비율, 텍스트 또는 편집 위치를 설명하십시오. 공식 작성 지침은 중국어 300자 이하 또는 영어 600단어 이하를 권장하며, 이는 바이트 제한이 아닌 지침입니다.
image	string 또는 string[]	공개 URL 또는 data:image/png;base64,.... 생성 레퍼런스는 최대 10개, 분해 시에는 정확히 하나의 입력입니다. 로컬 파일 시스템 경로는 작동하지 않습니다.
size	string	생성 시 기본값은 2K이며, 1K, 1.5K, 2K 또는 정확히 WIDTHxHEIGHT입니다. 분해 시 기본값은 auto이며, auto와 이 세 가지 등급만 허용합니다.
output_format	string, png	png 또는 jpeg. 분해 시에는 베이스만 제어하며, 레이어는 항상 PNG입니다.
background	string, auto	auto, transparent 또는 opaque이며, 생성 시에만 사용됩니다. 투명 출력에는 PNG가 필요하며, 분해 시에는 이 필드를 완전히 생략하십시오.
response_format	string, url	url 또는 b64_json. 모든 data[] 항목에서 일치하는 필드를 읽으십시오.
watermark	boolean, true	false로 설정하면 표시되는 AI 생성 워터마크를 생략합니다.
optimize_prompt_options	object	5.5는 {"mode":"standard"}만 지원하며, fast는 지원되지 않습니다.
layer_decomposition	boolean, false	하나의 PNG/JPEG 이미지 분해를 활성화합니다.
layer_decomposition_options	object	아래의 분해 옵션입니다.
layer_decomposition_options.max_images	integer, 30	2–100, 베이스 포함. 보장된 개수가 아닌 최대값입니다.
layer_decomposition_options.text_recognition	boolean, false	일반 텍스트 레이어에 대한 리치 텍스트 OCR을 요청합니다.
safety_identifier	string	안정적인 영어 사용자 식별자로 최대 64자이며, 개인 연락처 정보 대신 해시를 사용하십시오.

다른 모델의 resolution, quality, n 또는 seed를 사용하여 이 모델을 제어하지 마십시오. 이들은 공식 API에서 이 모델의 해당 생성 제어 항목으로 나열되지 않습니다. 분해 제한은 layer_decomposition_options.max_images로 설정하십시오.

크기 및 입력 제한

일반 생성의 경우 등급(1K, 1.5K, 2K)을 선택하고 프롬프트에 화면 비율을 설명하거나 정확한 치수를 제공하십시오. 정확한 출력 면적은 921,600–4,624,220 픽셀이어야 하며, 화면 비율은 1:16–16:1로 두 제약을 모두 충족해야 합니다. 2880x1440는 유효하며, 512x512는 너무 작습니다. 4K 등급은 없습니다.

분해는 정확한 치수를 허용하지 않습니다. auto를 사용하면 지원 범위 내의 베이스/레이어 크기는 가능한 한 원래 치수를 유지하며, 더 작거나 큰 항목은 화면 비율을 유지하면서 1K/2K 방향으로 조정됩니다. 반환된 레이어는 서로 다른 청구 등급을 차지할 수 있습니다.

입력 제약	생성/편집	분해
개수	최대 10	정확히 1
형식	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
이미지당 파일 크기	≤30 MB	≤30 MB
픽셀 면적	196–36,000,000, 양변 >14 px	262,144–36,000,000
화면 비율	1:16–16:1	1:16–16:1

데이터 URL에는 소문자 MIME 유형을 사용하십시오. 원격 입력 URL은 서비스에서 접근 가능해야 합니다.

편집 및 투명 이미지

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

입력이 하나인 경우 image는 문자열일 수 있습니다. 연속 편집의 경우 이전 출력을 다음 입력으로 명시적으로 전달하십시오. 이는 상태를 유지하는 대화가 아니며 각 요청은 개별 청구됩니다. 프롬프트에 좌표/상자/화살표를 설명하거나 레퍼런스에 표시를 그리십시오. 이 인터페이스에는 별도로 문서화된 mask 위치 지정 파라미터가 없습니다.

네이티브 투명 생성을 위해서는 필요하지 않은 경우 image를 생략하고 background: "transparent", output_format: "png"를 설정하며, "a translucent blue glass butterfly, isolated asset, transparent background"와 같은 프롬프트를 사용하십시오. 편집은 최대 10개의 레퍼런스를 사용할 수 있으며, 레퍼런스가 이미 알파 채널을 가질 필요는 없습니다. transparent와 jpeg의 조합은 유효하지 않습니다. 응답의 background는 실제 투명도(transparent 또는 opaque)를 설명합니다.

분해 및 리치 텍스트 OCR

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

베이스 하나와 최대 99개의 레이어를 지원합니다. max_images: 4에는 베이스가 포함됩니다. background를 생략하십시오. 모든 레이어는 투명 PNG입니다. 개별 레이어 실패는 부분 성공을 반환하는 대신 전체 요청을 실패로 만듭니다.

모든 data[] 항목을 읽으십시오:

• url/b64_json, size 및 output_format는 아티팩트와 실제 치수를 식별하며, background는 해당되는 경우 사용할 수 있습니다.
• z_index: 0는 베이스를 식별하며, 인덱스가 클수록 작은 인덱스 위에 나타납니다.
• name와 description는 레이어를 설명합니다.
• bounding_box.absolute는 출력 베이스 픽셀 기준의 [left,top,right,bottom]입니다. 레이어를 (right-left) × (bottom-top)로 크기 조정하고 (left,top)에 배치하십시오. 레이어 파일 치수는 캔버스 상의 크기와 다를 수 있습니다.
• bounding_box.normalized는 0–1000 좌표를 사용합니다. 가로/세로 좌표에 대상 캔버스 너비/높이를 곱하고 1000.로 나누십시오
• text_recognition는 요청된 경우에만 나타나며 레이어에 인식된 일반 텍스트가 포함된 경우에만 나타납니다. 손글씨, 예술적 레터링 및 비텍스트 레이어는 이를 생략할 수 있습니다.

OCR에는 text와 lines[]가 포함되며, 각 줄에는 자체 bounding_box와 스타일이 지정된 runs[]가 있습니다. 각 런(run)에는 text와 style가 있으며, 여기에는 similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow 및 translucent가 포함될 수 있습니다. 이들은 정확한 원본 디자인 속성이 아닌 대략적인 시각적 해석이며, 폰트 인식은 unknown를 반환할 수 있습니다.

응답, 저장 및 실패

응답에는 created, model, data[], usage.input_images 및 usage.generated_images가 포함됩니다. 생성된 개수에는 베이스와 레이어가 포함됩니다. 전체 응답 메타데이터를 보존하십시오. 원본 제공자 다운로드 URL은 24시간 후에 만료되므로, 자산을 신속히 다운로드/보관하십시오.

재시도하기 전에 잘못된 치수, 레퍼런스 개수 또는 호환되지 않는 투명도 옵션을 수정하십시오. 인증, 권한, 검열, 속도 제한 및 업스트림 실패를 별도로 처리하십시오. 오류를 성공적인 생성으로 해석하지 마십시오. IPM 제한은 계정/모델 버전당 생성된 이미지를 계산하며, 분해는 max_images를 예약하고 완료 후 미사용 용량을 반환하지만, 청구는 실제 생성된 이미지를 기준으로 합니다.

공식 출처: Seedream 5.5, 이미지 생성 API, 가격. 매개변수 확인일: 2026-11-13.