Seedream 5.5 API: 사용 가능 여부, 파라미터, 다음 단계

지금 reAPI의 비동기 이미지 엔드포인트에서 doubao-seedream-5-5로 Seedream 5.5 API를 호출할 수 있습니다. Seedream 5.5 API는 공개되어 있습니다. ByteDance는 2026년 11월 9일 이 모델을 발표했으며, BytePlus의 Lumina 스튜디오에서도 제공 중입니다.^[1][2]

이 가이드는 Seedream 5.5 API가 받는 입력, 크기와 레이어 분해의 작동 방식, 요청별 비용, 실행 가능한 요청 예제를 다룹니다. 파라미터와 가격 정보는 2026년 11월 10일 기준 reAPI API를 설명합니다.

핵심 요약

• reAPI에서 "model": "doubao-seedream-5-5"로 POST /api/v1/images/generations를 호출한 뒤 작업을 폴링해 이미지 URL을 받으세요.^[3]
• 크기는 1K, 1.5K, 2K와 열 가지 화면 비율 또는 정확한 픽셀로 지정할 수 있습니다. 레퍼런스 이미지는 최대 10장입니다. 3K와 4K는 지원하지 않습니다.^[3]
• 투명 출력은 프롬프트와 레퍼런스 이미지 모두에서 가능하며, 레이어 분해는 최대 100장의 이미지를 반환하고 텍스트 인식도 선택할 수 있습니다.^[3]
• reAPI의 출력 이미지당 요금은 1K 또는 1.5K에서 $0.013, 2K에서 $0.023이며, 레퍼런스 이미지당 $0.0052가 추가됩니다(2026년 11월 10일 출시 시점 가격).^[4]

Seedream 5.5 API의 현재 제공 상태

ByteDance가 이 모델에 대해 제시한 기능 설명은 발표문에 근거합니다. 100회에 걸쳐 편집하지 않은 영역을 그대로 유지하는 멀티턴 편집, 네이티브 투명 출력, 더 선명한 작은 글자가 핵심입니다. ByteDance 테스트에서 심한 텍스트 손상률은 0.4%, 경미한 손상률은 1.7%였습니다.^[1]

Seedream 5.5 API 파라미터

아래는 reAPI의 Seedream 5.5 요청 본문에 사용하는 필드입니다.^[3]

크기는 자주 혼동하는 필드입니다. 열 가지 비율은 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2이며, 하나를 골라 resolution과 조합해 등급을 지정하세요. 정확한 픽셀을 지정할 때는 총 픽셀 수가 921,6004,624,220, 가로세로 비율이 1/1616 범위여야 하며 resolution 없이 전송합니다.^[3]

Seedream 5.0 Pro와는 두 가지 규칙이 다릅니다. 5.5는 편집뿐 아니라 텍스트 투 이미지에서도 투명 출력이 가능하지만, 5.0 Pro는 정확히 한 장의 레퍼런스 이미지가 필요합니다. 또한 5.5의 레이어 분해에서는 반환할 이미지 수를 최대 100장까지 설정할 수 있는 반면, 5.0 Pro는 베이스 이미지와 최대 16개 레이어를 반환합니다.^[3][5]

실행 가능한 Seedream 5.5 API 요청

curl https://reapi.ai/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-5",
    "prompt": "A frosted glass perfume bottle with pale gold liquid, soft studio light",
    "size": "16:9",
    "resolution": "2K"
  }'

응답에는 status: "processing" 상태의 작업 id가 포함됩니다. 상태가 completed가 될 때까지 GET /api/v1/tasks/{id}를 폴링한 뒤 output.image_urls에서 이미지를 읽으세요. 생성된 URL은 만료되므로 결과를 자신의 저장소로 복사하세요.^[3]

텍스트 인식을 함께 사용하는 레이어 분해

이미지를 정확히 한 장 보내고 layer_decomposition을 켜되 background는 넣지 마세요.

{
  "model": "doubao-seedream-5-5",
  "image_urls": ["https://example.com/poster.png"],
  "layer_decomposition": true,
  "layer_decomposition_options": { "max_images": 10, "text_recognition": true },
  "size": "1K"
}

완료된 작업의 output.image_urls에는 베이스 이미지가 먼저, 그 뒤에 각 레이어가 나열됩니다. output.layers에는 이에 대응하는 항목이 포함됩니다. 쌓는 순서와 베이스 이미지 좌표계의 바운딩 박스가 담기며, OCR이 일반 텍스트를 찾으면 텍스트, 줄별 박스, 스타일 추정치가 포함된 text_recognition 객체도 담깁니다.^[3] 레이어 분해에는 몇 분이 걸릴 수 있으므로 다시 제출하지 말고 같은 작업을 계속 폴링하세요.

Seedream 5.5 API 요청이 실패할 때

대부분의 실패는 다음 네 가지 형태 중 하나로 나타나며, 그중 비용이 발생하는 경우는 하나뿐입니다.^[3]

• 제출 시 동기적으로 반환되는 400. 목록에 없는 비율, 투명 배경의 jpeg, 정확히 한 장의 이미지가 없는 레이어 모드처럼 필드가 문서에 명시된 규칙을 위반한 경우입니다. 오류에는 해당 필드가 표시되며 요금은 청구되지 않습니다.
• 제출 시 반환되는 402. 잔액이 예치액을 충당하지 못하는 경우입니다. 레이어 분해는 max_images장분을 예치하므로 이 상한을 낮추면 도움이 됩니다.
• 작업 실패. 콘텐츠 정책에 따른 거부, 접근할 수 없는 이미지 URL, AVIF 같은 미지원 형식은 작업을 실패로 종료시키며, 예치액은 전액 환불됩니다.
• 오래 지속되는 processing 상태. 레이어 분해에는 몇 분이 걸릴 수 있습니다. 다시 제출하면 비용이 두 번 발생하므로 같은 작업을 계속 폴링하세요.

Seedream 5.5 API 비용

reAPI는 Seedream 5.5의 출력 이미지마다 크기 구간별 요금을 청구하며, 모든 레퍼런스 이미지에도 과금합니다. 첫 번째 레퍼런스도 무료가 아닙니다.^[3] 2026년 11월 10일 출시 시점 요금은 다음과 같습니다.^[4]

정수 크레딧 단위로 올림한 예시입니다(1 credit = $0.001). 2K 텍스트 투 이미지 요청은 23 credits, 레퍼런스 이미지 한 장을 쓰는 1K 편집은 19 credits입니다.^[4]

레이어 분해는 요청한 크기 구간에 맞춰 max_images장분의 크레딧을 예치한 뒤 실제로 반환된 이미지 수에 따라 정산하며, 입력 이미지 한 장의 요금은 한 번만 청구됩니다. 최대 10장으로 설정한 1K 분해는 136 credits를 예치합니다. 네 장을 반환하면 비용은 58 credits이며 나머지는 환불됩니다. 실패한 작업은 전액 환불됩니다. 비교하자면 같은 날 reAPI의 Seedream 5.0 Pro는 1K 이미지당 $0.032, 2K 이미지당 $0.063였습니다.^[5]

작업에 맞는 크기와 레퍼런스 선택하기

이 요금 구간에서는 작업에 필요한 최소 크기를 고르는 것이 비용 면에서 유리합니다. 다음은 품질 테스트가 아닌 크기 구간과 입력의 과금 방식에 근거한 저희 제안입니다.

• 초안과 소셜 이미지. 1.5K는 1K와 가격이 같으므로 낮은 요금 구간의 기본값으로 더 적합합니다.
• 인쇄물, 포스터, 촘촘한 텍스트. 2K는 작은 글자에 가장 많은 픽셀을 할당합니다. ByteDance가 렌더링 개선을 보고한 영역입니다.^[1]
• 제품 편집. 깔끔한 레퍼런스 이미지 한 장으로 시작하세요. 이미지마다 요금이 청구되므로 두 번째 이미지에 배경이나 로고처럼 첫 번째에 없는 정보가 있을 때만 추가하세요.
• 레이아웃용 에셋. 흰 배경으로 생성한 뒤 누끼를 따는 대신 PNG 출력과 함께 background: "transparent"를 요청하세요.

Seedream 5.5 API 연동을 위한 다음 단계

이 체크리스트는 저희 편집팀의 조언입니다.

1. 플레이그라운드에서 시작하세요. Seedream 5.5 페이지는 같은 파라미터로 실행되며 생성 전에 비용을 보여 줍니다.
2. 비동기 패턴을 사용하세요. 제출하고 폴링한 뒤 결과를 복사하세요.
3. 모델 ID를 한 곳의 설정에서 관리하세요. 같은 프롬프트로 Seedream 5.5와 5.0 Pro를 비교할 수 있습니다.
4. 레퍼런스 비용을 예산에 반영하세요. 레퍼런스 이미지마다 가격이 올라가므로 실제로 몇 장이 필요한지 테스트하세요.
5. 레이어 분해 수에 상한을 두세요. 필요한 만큼 max_images를 설정하세요. 이 값에 따라 예치액이 정해집니다.

자주 묻는 질문

Seedream 5.5 API가 있나요?

네. reAPI는 이미지 API에서 doubao-seedream-5-5로 Seedream 5.5를 제공합니다.^[3]

Seedream 5.5 API는 무료인가요?

아닙니다. reAPI에서는 구독 없이 선불 크레딧으로 사용한 만큼 지불합니다. 출력 이미지와 레퍼런스 이미지마다 요금이 청구되며, 실패한 작업은 환불됩니다.^[4]

Seedream 5.5 API 튜토리얼이 있나요?

Seedream 5.5 API 문서는 cURL, Python, Node.js, Go 요청 예제, 모든 파라미터, 레이어 분해 출력, 과금 방식을 안내합니다. 위 예제는 실행 가능한 가장 짧은 요청입니다.^[3]

Seedream 5.5를 다운로드할 수 있나요?

아닙니다. ByteDance는 Seedream 5.5의 가중치나 다운로드 가능한 모델을 공개하지 않았습니다. ByteDance 앱과 API에서 호스팅 모델로 실행됩니다.^[1][2]

Seedream 5.5 텍스트 투 이미지 문서는 어디에 있나요?

reAPI에서는 Seedream 5.5 API 문서를 보면 됩니다.

Seedream 5.5 API 키는 어떻게 발급받나요?

reAPI 대시보드에서 키를 생성하고 Bearer 토큰으로 전달하세요. 같은 키로 Seedream 5.5와 계정의 다른 모든 모델을 호출할 수 있습니다.

지금 Seedream 5.5 API 호출하기

모델은 이미 출시되어 호출할 수 있습니다. reAPI 이미지 엔드포인트에 doubao-seedream-5-5를 보내세요. Seedream 5.5 API를 코드에 연동하기 전에 플레이그라운드에서 크기와 레퍼런스를 조정하는 것으로 시작하세요.

참고 자료

1. ByteDance Seed. 더 사실적인 이미지, 100회에 걸친 더 안정적인 편집 | Seedream 5.5 소개. 2026년 11월 확인: seed.bytedance.com/en/blog/more-realistic-images-more-stable-editing-across-100-rounds-introducing-seedream-5-5
2. BytePlus. Seedream 5.5 출시일: 2026년 11월 9일 공식 출시. 2026년 11월 확인: ai.byteplus.com/lumina/en/resource/seedream-5-5-release-date
3. reAPI. Seedream 5.5 API 문서. 2026년 11월 확인: reapi.ai/docs/seedream-5-5
4. reAPI. Seedream 5.5. 2026년 11월 확인: reapi.ai/models/seedream-5-5
5. reAPI. Seedream 5.0 Pro API 문서 및 모델 페이지. 2026년 11월 확인: reapi.ai/docs/seedream-5-0-pro 및 reapi.ai/models/seedream-5-0-pro