Seedream 5.5 API 사용 방법

Seedream 5.5는 EmpirioLabs에서 이용 가능합니다. 이 모델은 바이트댄스의 최신 Seedream 이미지 모델로, 2026년 11월 9일에 출시되었으며, 최대 10개의 참조 이미지, 프롬프트나 참고문헌에서 생성된 실제 투명 이미지, 그리고 한 이미지를 기본 이미지와 최대 99개의 투명 레이어로 분할하고 그 안의 텍스트를 읽을 수 있는 레이어 분해를 결합하는 편집을 위한 text-to-image 생성 모델입니다. API와 Playground에서 모두 작동합니다.

출시 영상을 시청하세요

영화의 모든 사진은 2K에서 EmpirioLabs API를 통해 Seedream 5.5가 제작했으며, 혹등고래 옆에 있는 프리다이버, 회전 중인 플라멩코 무용수, 작업 중인 유리공예가, 그리고 글자가 적힌 재즈 포스터가 포함되어 있습니다. 음악은 EmpirioLabs의 ACE-Step에서 제작했습니다. 유튜브에서 시청하세요·.

비교

지원하는 바

• 텍스트-이미지. 이미지 없이 프롬프트를 보내세요.
• 편집과 융합. 1장에서 10장의 이미지를 첨부하고 변화 과정이나 결합 방법을 설명하세요.
• 마커와 좌표 편집. 입력 이미지에서 변경할 영역을 원, 화살표 또는 스케치로 표시하거나, 정확한 위치는 <bbox> 프롬프트에 태그를 넣으세요.
• 투명한 이미지들. 설치하기 배경 로 투명 프롬프트만으로, 또는 참고 이미지에서 알파 채널이 포함된 PNG를 얻는 것.
• 층 분해. 한 이미지를 기본 이미지와 최대 99개의 투명 PNG 레이어로 나누고, 각 레이어는 기본 이미지에서의 위치, 이름, 설명을 함께 반환합니다.
• 텍스트 인식. 분해 과정 중에는 각 인쇄된 텍스트 레이어의 텍스트와 그 선 위치, 스타일링을 받아보세요.
• 이미지 속의 텍스트. 간판, 라벨, 포스터, 소문자는 중국어, 영어 및 일본어, 한국어, 아랍어, 스페인어, 프랑스어 등 14개 언어로 표현되어 있습니다.

출력은 기본적으로 PNG이거나, 1K, 1.5K 또는 2K 해상도 계층에서 JPEG로 나오거나, 커스텀 너비와 높이로 제공됩니다.

이미지 생성

curl https://api.empiriolabs.ai/v1/images/generations \ -H "인증: 보유자 $EMPIRIOLABS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-5-5", "prompt": "작은 칠판 간판 옆에 세라믹 커피 컵이 놓여 있는데, 그 간판에는 Oat Flat White 4.50, 아침 창문 빛", "aspect_ratio": "4:3", "품질": "2K" }'

요청은 완성된 이미지를 기다렸다가 반환합니다 데이터. 추가 "동기화": 거짓 즉시 다시 일자리를 얻으려 했고, 작업 id 투표 장소는 빨리 /v1/jobs/<job_id> 그러다 현황 이야. 지원하다·.

OpenAI Python SDK에서 EmpirioLabs를 가리키는 동일한 호출입니다. SDK가 정의하지 않는 컨트롤은 들어가야 합니다 extra_body::

openai로부터 가져오기 OpenAI 클라이언트 = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY",) 결과 = client.images.generate(model="seedream-5-5", prompt="작은 이끼 풍경과 'Fern Garden'이라고 적힌 황동 라벨이 붙은 유리 테라리움", extra_body={"aspect_ratio": "4:3", "quality": "2K"},) print(result.data[0].url)

투명한 이미지를 만드세요

설치하기 배경 로 투명. 프롬프트만으로도 작동하며, 자체 알파 채널이 필요 없는 최대 10개의 참조 이미지 편집에도 적용됩니다. 출력은 PNG이어야 합니다:

{ "모델": "seedream-5-5", "프롬프트": "금색 술이 달린 광택 있는 빨간 종이 랜턴, 분리된 제품 컷아웃", "배경": "투명", "품질": "1K" }

반환된 각 이미지는 실제로 포함된 내용을 다음과 같이 보고합니다 배경:: 투명 또는 불투명. 떠나세요 배경 at 오토, 기본값이며, 모델은 프롬프트와 출력 형식을 바탕으로 결정합니다.

참고 이미지를 포함한 편집

최대 10개의 이미지 URL, 데이터 URI 또는 업로드된 이미지를 전달할 수 있습니다 이름 *, 그리고 프롬프트에서 순서대로 그들을 참조하세요:

{ "model": "seedream-5-5", "prompt": "이미지 2의 가지에 빨간 종이 랜턴을 걸고, 이미지 2의 다른 모든 것은 변경하지 마세요", "image": [ "https://example.com/lantern.png", "https://example.com/branch-poster.png" ] }

표시된 영역을 편집하기

이미지의 한 부분을 변경하려면 입력 부분에 원, 화살표 또는 스케치를 표시하고 변화를 설명하거나, 영역을 다음과 같이 지정하세요 <bbox> 태그. 상자는 왼쪽, 위, 오른쪽 아래, 이미지 위의 0에서 1000 그리드에서, 픽셀 크기와 상관없이 다음과 같습니다:

{ "모델": "seedream-5-5", "프롬프트": "<bbox>60 80 300 520</bbox> 안에 흰 튤립 한 송이가 있는 작은 유리 꽃병을 추가하세요. 나머지는 모두 변경하지 마세요.", "이미지": "https://example.com/kitchen.png" }

이미지를 여러 레이어로 나누기

설치하기 layer_decomposition 로 맞아요 그리고 정확히 한 장의 이미지를 첨부하세요. 프롬프트는 선택 사항입니다: 모델이 요소를 선택하도록 하기 위해 프롬프트를 빼거나, 분리할 요소나 영역의 이름을 지정하세요. max_images 기본 이미지를 포함해 반환할 가장 많은 이미지를 2에서 100까지 설정합니다. text_recognition 각 인쇄된 텍스트 레이어의 텍스트를 추가합니다:

curl https://api.empiriolabs.ai/v1/images/generations \ -h "인증: 베어러 $EMPIRIOLABS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedream-5-5", "layer_decomposition": true, "image": "https://example.com/magazine-cover.png", "max_images": 10, "text_recognition": true }'

데이터[0] 는 기본 이미지이며, z_index 0의 집합입니다. 그 뒤에 따르는 각 항목은 투명한 PNG 레이어이며, 스태킹 순서와 기본 이미지 내 픽셀 단위의 박스(bounding_box 절대적이다) 그리고 0에서 1000 그리드(bounding_box. 정규화), 둘 다 [왼쪽, 위, 오른쪽, 아래], 그리고 이름과 설명을 포함합니다. 인쇄된 텍스트 레이어도 다음을 전달합니다. text_recognition::

{ "url": "https://media.empiriolabs.ai/...", "z_index": 1, "너비": 1723, "높이": 609, "bounding_box": { "절대": [75, 0, 995, 325], "normalized": [69, 0, 921, 301] }, "name": "상단 노란색 큰 세리프체 제목 텍스트 Seedream", "설명": "큰 노란색 세리프체 제목 텍스트 \"Seedream\"이 구성의 상단에 위치.", "text_recognition": { "텍스트": "Seedream", "라인": [ { "bounding_box": { "절대": [196, 53, 874, 231], "normalized": [181, 49, 809, 214] }, "runs": [ { "text": "Seedream", "style": { "similar_font_family": "HTF Didot", "foreground_color": "#F5E25A", "bold": false, "이탤릭체": false, "밑줄": false, "strikethrough": false, "shadow": false, "translucent": false } ] }, "background": "transparent" }

레이어를 기본 이미지 위에 오름차순으로 쌓으세요 z_index 레이어를 다시 만들거나, 이동, 크기 변경, 색상 변경 또는 교체를 먼저 할 수 있습니다. 인식된 텍스트를 사용하면 레이어를 다시 타이핑, 번역 또는 스타일링하여 다시 해당 행의 박스에 배치할 수 있습니다.

첫 요청 전에 알아야 할 사항

• 요청당 한 장씩 이미지 한 장씩. 요청은 한 장의 이미지를 반환하고, n 1 이상은 오류를 반환합니다. 변형에 대한 별도의 요청을 보냅니다. 레이어 분해는 예외로, 기본 이미지와 그 레이어를 함께 반환합니다.
• 설치하기 max_images 필요한 분해를 위해서요. 이 값이 없으면 분해 시 최대 30장의 이미지를 반환할 수 있으며, 각 이미지가 반환되는 것은 청구서입니다. 더 큰 값은 더 미세한 분할을 가능하게 합니다.
• 각 레이어를 박스에 맞게 축소하세요. 레이어 PNG는 항상 기본 이미지의 풋프린 크기만 있는 것은 아닙니다: 위 예시에서 1723x609 레이어가 920x325 박스를 채웁니다. 각 레이어는 너비와 높이에 맞게 스케일링하세요 bounding_box 절대적이다 그리고 상자 왼쪽 상단 모서리에 놓았다.
• 텍스트 인식은 인쇄된 텍스트를 읽습니다. 예술적인 글씨와 필체는 겹겹이 쌓여 다시 등장합니다. text_recognition·.
• 분해는 없습니다 배경·. 레이어는 항상 투명한 PNG이고, 설정도 배경 로 투명 또는 불투명 이름 * layer_decomposition 오류가 반환됩니다.
• 투명한 결과는 PNG가 필요합니다. 배경: "투명" 이름 * output_format: "jpeg" 오류가 반환됩니다.

제품정보

이미지에 따르면. Seedream 5.5는 사용량 당시 지불하며, 반환된 이미지당 크기별로 요금을 청구합니다: 1K와 1.5K 이미지는 동일한 요금을 공유하고, 2K 이미지는 더 높은 요금으로 청구됩니다. 각 참조 이미지는 요금을 추가합니다. 레이어 분해는 반환되는 각 이미지, 기본 이미지, 각 레이어를 자체 크기로 청구합니다. 사용량을 그대로 지불하거나 주간 할당량이 있는 플랜을 선택할 수 있습니다. 현재 요금은 모델 페이지 그리고 가격표·.

콘텐츠 안전. 생성된 이미지는 자동 콘텐츠 안전 검사를 통과합니다. 명시적으로 표시된 이미지는 반환되지 않으며, 검사 이전에 생성되었기 때문에 여전히 청구됩니다.

건설 시작

Seedream 5.5를 시도해 보세요. Playground전체 매개변수 참조를 읽어, API 문서또는 다른 이미지 모델들과 비교할 수도 있습니다. 모델 카탈로그. 초기 가족 모델에 대해서는 다음을 참조하세요 Seedream 5.0 Pro API 사용 방법 그리고 Seedream 5.0 플래시 API 사용 방법·.