Seedream 5.5 API 가이드: 가격, 파라미터 및 호출 예시

Seedream 5.5로 할 수 있는 것

Seedream 5.5는 HiAPI의 이미지 모델로, 하나의 모델 ID(seedream-5.5)가 두 가지 용도를 동시에 지원합니다. 프롬프트만 작성하면 텍스트-이미지 생성이고, 참조 이미지를 첨부하면 참조 이미지에 따라 편집하거나 화면 내용을 유지하는 것입니다. 두 용도는 동일한 인터페이스, 동일한 파라미터 세트를 사용하며, 차이는 요청에 image_urls가 있는지 여부뿐입니다.

호출할 때마다 이미지 한 장을 반환합니다. 아래에서는 '가격 계산 방식 → 파라미터 입력 방식 → 요청 전송 방식 → 제한 사항' 순서로 설명하며, 모든 수치는 이 글 작성 시점의 인터페이스 정의를 기준으로 합니다.

가격: 픽셀 등급별 과금, 참조 이미지는 장당 추가

비용은 두 부분으로 구성됩니다. 출력 등급의 기본 가격에 참조 이미지 비용을 더한 것입니다.

• 1K / 1.5K: $0.0186 / 장
• 2K(기본 등급): $0.0325 / 장
• 참조 이미지: 장당 $0.0075, 첫 장도 과금, 최대 10장

몇 가지 예시:

• 1K 텍스트-이미지 생성, 참조 이미지 없음: $0.0186
• 2K, 참조 이미지 1장: $0.0325 + $0.0075 = $0.04
• 2K, 참조 이미지 10장(상한): $0.0325 + $0.075 = $0.1075

size를 작성하지 않으면 2K로 생성되고 2K로 과금됩니다. 초안이나 작은 크기의 삽입 이미지를 만들 때 "size": "1K"를 명시하면 약 40%를 절약할 수 있습니다. 작업이 실패하면 비용은 전액 환불됩니다.

파라미터 일람

model과 prompt를 제외하면 모두 선택 파라미터입니다:

• prompt: 필수, 1–5000자. 생성할 화면을 설명합니다. 참조 이미지가 있을 때는 무엇을 변경하고 무엇을 유지할지 명확히 작성합니다.
• size: 1K, 1.5K, 2K, 기본값 2K.
• aspect_ratio: 10가지 선택 가능 — 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 2:1, 1:2. 작성하지 않으면 모델이 프롬프트와 참조 이미지에 따라 자동으로 선택합니다.
• image_urls: 1–10개의 공개 접근 가능한 http(s) 이미지 주소. 작성하지 않으면 순수 텍스트 생성입니다.
• output_format: png 또는 jpeg, 기본값 png.
• background: auto, transparent, opaque, 기본값 auto. transparent를 선택하면 출력 형식은 png만 가능하며, jpeg와 조합하면 거부됩니다.

요청 보내기

HiAPI의 이미지 작업은 비동기식입니다. 먼저 작업을 생성한 다음 결과를 조회합니다. model은 최상위에 두고, 나머지 파라미터는 input에 넣습니다.

텍스트-이미지 생성(2K, 16:9):

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "input": {
      "prompt": "清晨的海边灯塔，薄雾，柔和的侧光，写实摄影风格",
      "size": "2K",
      "aspect_ratio": "16:9"
    }
  }'

참조 이미지 편집(1K, 투명 배경, PNG):

{
  "model": "seedream-5.5",
  "input": {
    "prompt": "병과 라벨은 유지하고 배경을 제거한 뒤 부드러운 상단 조명으로 변경",
    "image_urls": ["https://example.com/bottle.jpg"],
    "size": "1K",
    "background": "transparent",
    "output_format": "png"
  }
}

이 요청의 비용은 $0.0186 + $0.0075 = $0.0261입니다. 생성에 성공하면 반환된 작업 ID로 GET https://api.hiapi.ai/v1/tasks/{taskId}를 호출해 폴링하고, 상태가 성공으로 바뀌면 출력에서 이미지 주소를 가져와 다운로드합니다.

현재 제한 사항

• 최대 2K이며 4K 등급은 없습니다.
• 이미지 레이어 분리 출력은 지원하지 않습니다.
• 호출할 때마다 이미지 한 장만 생성되며, 여러 장이 필요하면 여러 작업을 동시에 보냅니다.
• 참조 이미지는 공용 인터넷에서 접근 가능한 http(s) 주소여야 하며, 로컬 파일 경로나 base64는 허용되지 않습니다.
• 투명 배경은 PNG만 지원합니다.

등급 선택 방법

바로 출시할 포스터나 상품 대표 이미지는 기본 2K를 사용합니다. 내부 검토용 초안, 대량 스타일 테스트, 작은 크기의 썸네일에는 1K 또는 1.5K를 사용합니다(둘은 같은 가격이며, 1.5K가 더 선명하므로 1K를 선택할 이유가 없을 때는 1.5K를 바로 사용합니다). 참조 이미지는 장당 과금되므로 결과에 실제로 영향을 주는 몇 장만 넣습니다. 같은 상품의 여러 각도 이미지는 먼저 1–2장으로 시도하고, 효과가 부족하면 추가합니다.