Seedream
Seedream 5.0 Pro의 제한, 그리고 프롬프트에 적은 픽셀 좌표와 색상 코드로 하는 정밀 영역 편집.
Seedream 5.0 Pro는 ListenHub에서 쓰는 ByteDance의 이미지 모델이자, 전체 모델 목록에서 정밀 편집을 지원하는 유일한 모델입니다 — 전체를 다시 생성하는 대신 기존 이미지의 지정한 영역을 바꿉니다. 공유 이미지 엔드포인트에서 동작합니다. 엔드포인트, 요청 스키마, 비동기 흐름, 에러 코드는 이미지 생성 개요를 참고하세요. 이 페이지는 Seedream 전용 내용만 다룹니다.
모델
| 모델 | 표시 이름 | 적합한 용도 |
|---|---|---|
seedream-5-0-pro | Seedream 5.0 Pro | 주어진 이미지의 특정 영역을 편집 |
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는 원본 이미지의 실제 비율과
일치시키세요. 일치하지 않으면 모델이 한 영역만 편집하는 대신 이미지 전체를 재구성할 수 있습니다.
요금
Seedream은 이미지 크기별 고정 크레딧 비용으로 과금되며(pricing.mode는 fixed),
requiresSubscription을 설정하는 일이 없습니다. 무료 할당량 리소스(seedream-5-0-pro)가 있고
1K와 2K에서 사용할 수 있습니다 — 이 모델이 지원하는 모든 크기입니다. 정확한 수치는
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" }
}'전체 파라미터 목록과 참조 이미지를 포함한 요청 구조는 이미지 생성 개요를 참고하세요.