ListenHubDocs
API 레퍼런스이미지 생성

Seedream

Seedream 5.0 Pro와 5.5의 모델, 크기 제한, 참조 이미지 및 크레딧 요금.

Seedream 5.0 Pro와 Seedream 5.5는 ListenHub의 ByteDance 이미지 모델입니다. 공통 이미지 엔드포인트로 텍스트와 참조 이미지를 사용해 이미지를 생성합니다. 아래 정밀 편집 예시는 Seedream 5.0 Pro를 사용합니다. 엔드포인트, 요청 스키마, 비동기 흐름, 에러 코드는 이미지 생성 개요를 참고하세요.

모델

모델표시 이름적합한 용도
seedream-5-0-proSeedream 5.0 Pro주어진 이미지의 특정 영역을 편집
seedream-5-5Seedream 5.5텍스트 및 참조 이미지로 이미지 생성

provider: "bytedance"를 사용합니다.

제한

제한 항목값
이미지 크기1K, 2K — 4K는 400 반환
화면 비율네 가지 극단 비율을 포함한 14종 전부
기본 화면 비율요청 스키마 기준 1:1
참조 이미지최대 10장
quality무시됨

Seedream은 비율이 아니라 크기로 검증합니다. 스키마가 받아들이는 모든 비율이 범위 내이며, Nano Banana에서는 Flash만 받는 네 가지 극단 비율도 포함됩니다. 출력 픽셀 수는 크기 예산과 함께 보낸 aspectRatio로 계산되는데, 스키마 기본값이 1:1이므로 원본 이미지에 맞도록 명시적으로 지정하세요. 하나뿐인 하드 제한은 크기입니다: 4K는 조용히 2K로 낮춰지지 않고 code: 29003과 함께 그대로 거부됩니다.

정밀 편집

별도의 편집 엔드포인트도, 마스크나 영역 파라미터도 없습니다. 편집은 같은 생성 엔드포인트를 사용하며, 원본 이미지는 referenceImages에 넣고 "무엇을 어떻게 바꿀지"는 prompt에 적습니다. 모델은 절대 픽셀 좌표(원점은 이미지의 왼쪽 위 모서리)와 업계 표준 색상 코드를 프롬프트 텍스트에서 직접 읽습니다.

{
  "provider": "bytedance",
  "model": "seedream-5-0-pro",
  "prompt": "Treating the top-left corner as the coordinate origin, change the content inside top-left:(376,363) bottom-right:(701,638) to green, and leave everything else unchanged",
  "referenceImages": [
    {
      "fileData": {
        "fileUri": "https://assets.listenhub.app/your-source-image.png",
        "mimeType": "image/png"
      }
    }
  ],
  "imageConfig": { "imageSize": "2K", "aspectRatio": "1:1" }
}

서버는 프롬프트를 그대로 전달하며 좌표를 파싱하지 않습니다. 제품에서 시각적인 편집 제스처(박스 선택, 올가미, 화살표)를 제공한다면, 직접 만든 프런트엔드에서 그것을 좌표 문자열로 변환하거나 주석을 참조 이미지에 그려 넣은 뒤 prompt에 적으세요. aspectRatio는 원본 이미지의 실제 비율과 일치시키세요. 일치하지 않으면 모델이 한 영역만 편집하는 대신 이미지 전체를 재구성할 수 있습니다.

요금

두 모델 모두 크기별 고정 요금(pricing.mode: "fixed")으로 1K는 6 크레딧, 2K는 15 크레딧이며 구독이 필요하지 않습니다. seedream-5-0-pro 무료 할당량은 Seedream 5.0 Pro에만 적용됩니다. Seedream 5.5는 이 할당량을 공유하지 않습니다. 현재 예상 요금은 POST /v1/images/generation/estimate-credits에서 확인하세요.

예시

curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/async" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bytedance",
    "model": "seedream-5-0-pro",
    "prompt": "Treating the top-left corner as the coordinate origin, repaint the jacket inside top-left:(120,240) bottom-right:(520,880) in #1F4D3A, keep the face, hair and background unchanged",
    "referenceImages": [
      { "fileData": { "fileUri": "https://example.com/portrait.png", "mimeType": "image/png" } }
    ],
    "imageConfig": { "imageSize": "2K", "aspectRatio": "3:4" }
  }'

전체 파라미터 목록과 참조 이미지를 포함한 요청 구조는 이미지 생성 개요를 참고하세요.

이 페이지의 내용