
네이티브 투명 출력, 정밀한 다중 라운드 편집, 최대 99개의 편집 가능한 레이어로 분해하고 텍스트 인식이 가능한 Seedream 이미지 모델입니다.
네이티브 투명 출력, 정밀한 다중 라운드 편집, 최대 99개의 편집 가능한 레이어로 분해하고 텍스트 인식이 가능한 Seedream 이미지 모델입니다.
다른 이름 ByteDance Seedream 5.5
seedream-5-5/v1/images/generationsbytedance/dola-seedream-5-5-261028bytedance/seedream-5-5byteplus/dola-seedream-5-5-261028byteplus/seedream-5-5dola-seedream-5-5-261028seedream-5-5-261028seedream-5.5EmpirioLabs 카탈로그의 실시간 종량제 요금입니다. 사용한 만큼만 결제하며 월 최소 요금이 없습니다.
Seedream 5.5은(는) POST /v1/images/generations로 실행됩니다. 요청은 즉시 job_id를 반환하며, 작업이 완료될 때까지 GET /v1/jobs/{job_id}을 폴링한 뒤 결과에서 출력 URL을 읽으세요. 또는 "sync": true를 추가해 폴링을 생략할 수 있습니다. 요청이 열린 상태로 완성된 OpenAI 스타일 이미지 응답을 바로 반환하므로 OpenAI SDK가 그대로 동작합니다. EmpirioLabs 대시보드에서 API 키를 발급받으세요.
curl https://api.empiriolabs.ai/v1/images/generations \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-5",
"prompt": "Describe what you want Seedream 5.5 to generate."
}'curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
-H "Authorization: Bearer $EMPIRIOLABS_API_KEY"import requests
response = requests.post(
"https://api.empiriolabs.ai/v1/images/generations",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
json={
"model": "seedream-5-5",
"prompt": "Describe what you want Seedream 5.5 to generate.",
},
)
job = response.json()
# Generation runs as an async job. Poll until it completes.
import time
while True:
status = requests.get(
f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
).json()
if status.get("status") in ("completed", "failed"):
print(status)
break
time.sleep(5)EmpirioLabs에서 Seedream 5.5 API가 지원하는 요청 파라미터입니다. 필드를 생략하면 기본값이 적용됩니다.
| 파라미터 | 유형 | 기본값 | 범위 / 값 | 설명 |
|---|---|---|---|---|
| prompt | string | - | - | 텍스트 프롬프트. 이미지가 첨부되면 편집 또는 융합 지시가 됩니다. |
| image | array | - | - | 참조 이미지 URL, 데이터 URI, 또는 업로드된 이미지 객체를 지원합니다. Seedream 5.5는 최대 10개의 참조 이미지를 지원하며, 레이어 분해를 위해 정확히 1장을 지원합니다. |
| images | array | - | - | 이미지의 별칭입니다. 여러 개의 업로드된 이미지 참조에 이 기능을 사용하세요. |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 | Auto는 모델이 선택한 해상도 계층 내에서 치수를 선택할 수 있게 합니다. 명시적 비율은 해당 티어의 프리셋 크기를 사용합니다. |
| layer_decomposition | boolean | false | - | 입력 이미지 하나를 기본 이미지와 최대 99개의 투명 PNG 레이어로 분할하며, 각 레이어는 스태킹 순서, 기본 이미지 내 위치, 이름, 설명을 반환합니다. 입력 이미지는 정확히 한 장의 이미지가 필요합니다. 프롬프트는 선택 사항이며, 분리할 요소나 좌표 영역의 이름을 지정할 수 있습니다. |
| max_images | number | 30 | 2 ~ 100 | 레이어 분해만 가능합니다. 기본 이미지 포함 최대 반환 이미지는 2장부터 100장까지; 모델은 실제 수치를 결정합니다. 반환된 이미지에 대해서만 청구됩니다. |
| text_recognition | boolean | false | - | 레이어 분해만 가능합니다. 또한 각 일반 텍스트 레이어의 텍스트, 줄 위치, 스타일링(유사한 글꼴, 색상, 굵기, 이탤릭체, 밑줄, 취소선, 그림자, 투명도)도 text_recognition대로 반환합니다. 예술적 텍스트와 필체는 인식되지 않습니다. |
| quality | enum | 2K | 1K, 1.5K, 2K | 출력 해상도 계층. 1.5K는 1K와 동일한 가격이며 더 높은 해상도를 제공합니다. 기본값은 2K입니다. 레이어 분해에서는 이 설정을 남겨두면 입력 이미지와 일치합니다. |
| size | string | - | - | 해상도 등급이나 1K, 1.5K, 2K, 2048x1152와 같은 명시적인 픽셀 크기 등이 있습니다. 명시적인 픽셀은 aspect_ratio와 품질을 덮어쓴다. 레이어 분해는 티어나 자동 전용만 받습니다. |
| use_custom_size | boolean | false | - | 프리셋 aspect_ratio와 품질 대신 custom_width와 custom_height를 사용하세요. 자동 설정일 때 적용aspect_ratio 적용됩니다. |
| custom_width | number | - | 15 ~ 8600 | 픽셀 단위의 맞춤 출력 폭. 총 면적은 [0.92MP, 4.62MP] 이내여야 하며, 화면 비율은 [1:16, 16:1] 반드시 되어야 합니다. |
| custom_height | number | - | 15 ~ 8600 | 픽셀 단위의 맞춤 출력 높이. 총 면적은 [0.92MP, 4.62MP] 반드시 [1:16, 16:1] 반드시 되어야 합니다. |
| watermark | boolean | false | - | 활성화되면 생성된 이미지에 AI가 생성한 출처 워터마크가 포함되어 있습니다. EmpirioLabs 별도의 워터마크를 추가하지 않습니다. |
| output_format | enum | png | jpeg, png | 출력 이미지 파일 형식. 레이어 분해에서는 기본 이미지 포맷을 설정하며, 레이어는 항상 PNG로 반환됩니다. |
스케치, 원, 화살표로 입력 이미지에서 직접 변경할 영역을 표시한 후 프롬프트에 설명하세요. 정확한 위치를 원하시면, 0에서 1000 정규화된 격자에 좌표 태그를 사용하세요:
Place the subject from image 1 <bbox>179 283 796 986</bbox> at the position in image 2 <bbox>118 331 933 871</bbox>.layer_decomposition 를 true로 설정하고 입력 이미지가 정확히 한 장으로 설정되어 기본 이미지와 최대 99개의 투명 PNG 레이어로 분할됩니다. max_images 기본 이미지를 포함한 가장 많은 이미지를 2에서 100으로 설정하며, 기본값은 30입니다; 값이 높을수록 더 세밀한 분해가 가능합니다. 반환된 모든 이미지는 스태킹 순서를 z_index으로 유지하며, 각 레이어는 기본 이미지에서 bounding_box.절대와 bounding_box.normalized, 이름과 설명 형태로 위치를 유지합니다. 이미지를 재조립할 때 각 레이어를 해당 박스로 축소하세요. 프롬프트를 비워 두어 모델이 요소를 선택하거나, 분리할 요소나 좌표 영역에 이름을 지정하세요. 해상도는 1K, 1.5K, 또는 2K를 수용하며, 설정이 해제될 때 입력 이미지와 일치합니다.
text_recognition가 켜지면 각 일반 텍스트 레이어도 text_recognition 반환합니다: 전체 텍스트, 각 줄의 위치, 각 텍스트 연속의 스타일링(유사한 글꼴, 색상, 굵기, 이탤릭체, 밑줄, 취소선, 그림자, 투명도). 예술적 텍스트와 필체는 인식되지 않습니다.
배경은 기본값이 Auto로, 모델이 프롬프트와 출력 형식을 바탕으로 선택할 수 있습니다. Transparent는 텍스트만으로도 또는 최대 10개의 참조 이미지에서 알파 채널이 필요한 이미지를 반환하며, PNG 출력이 필요합니다. Opaque는 알파 채널이 없는 이미지를 반환합니다. 반환된 각 이미지는 실제 투명도를 배경으로 보고합니다. 레이어 분해는 배경을 가져가지 않으며, 레이어는 항상 투명 PNG입니다.
반환된 각 이미지는 자체 크기로 청구합니다: 최대 2.61MP(1K 및 1.5K를 포함)나 2.61MP 이상(2K을 포함)입니다. 모든 입력 이미지가 비용을 청구하며, 레이어 분해용 이미지도 포함됩니다. 레이어 분해는 반환된 모든 이미지, 기본 이미지, 각 레이어를 자신의 크기로 청구합니다.
생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않습니다. 이미지가 검사 실행 전에 생성되기 때문에, 플래그가 붙은 생성은 여전히 청구됩니다.
EmpirioLabs에서 Seedream 5.5은(는) 종량제로 청구됩니다: 최대 2.61MP 출력 $0.0332 이미지별로; 출력 2.61MP 이상 $0.0581 이미지별로; 입력 이미지 $0.0133 입력 이미지당. 이 페이지의 실시간 요금표는 항상 API 청구 금액과 일치합니다.
Seedream 5.5은(는) api.empiriolabs.ai의 POST /v1/images/generations를 통해 제공되며 표준 Bearer 토큰 인증을 사용합니다.
네. EmpirioLabs 플레이그라운드에서 API와 동일한 파라미터로 Seedream 5.5을(를) 브라우저에서 실행하므로 코드를 작성하기 전에 프롬프트를 테스트할 수 있습니다.
EmpirioLabs 계정을 만든 다음 대시보드의 API Keys에서 키를 생성하세요. 요금은 종량제 크레딧이라 실행한 요청에 대해서만 결제합니다.