플래그십 출력 품질
Seedream 5 Pro는 포토리얼한 장면, 에디토리얼 제품 사진, 정확한 이미지 내 텍스트를 1K/2K로 렌더링——GPT Image, NanoBanana와 동급입니다.
Seedream 5 Pro API 가이드
Seedream 5 Pro는 ByteDance의 플래그십 이미지 모델——다국어 이미지 내 텍스트 렌더링, 다중 참조 편집, 깔끔한 포토리얼 출력에 강합니다. Seedance API에서는 안정적인 별칭으로 간단한 REST 엔드포인트와 비동기 작업 폴링으로 호출합니다.
1K 또는 2K 출력
1:1, 16:9, 9:16, 2:3, 3:2 등
프롬프트 또는 최대 10장의 참조 이미지
HTTPS 기반 JSON
시작 요청
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations이 task_id를 반환합니다. status가 SUCCESS가 될 때까지 GET /v1/images/generations/:task_id를 폴링하고 images[].url을 읽으세요.
프로바이더 SDK나 예기치 않은 스키마 변경 없이, 플래그십 품질의 이미지 모델을 예측 가능한 REST 표면 뒤에 두고 싶은 팀이 선택합니다.
Seedream 5 Pro는 포토리얼한 장면, 에디토리얼 제품 사진, 정확한 이미지 내 텍스트를 1K/2K로 렌더링——GPT Image, NanoBanana와 동급입니다.
model "seedream-5-pro"만 호출하면 됩니다. 프로바이더 라우팅, 용량, 폴백은 저희 쪽에서 처리——업스트림 변경에 통합이 영향받지 않습니다.
1K 이미지당 9 크레딧, 2K당 18, 두 번째 참조 이미지부터 +0.8. estimated_credits가 생성 응답에 포함됩니다.
공개 인터페이스는 모델이 실제로 하는 일을 그대로 제공: 텍스트-이미지 생성과 최대 10장의 참조 이미지 편집.
최대 3000자의 프롬프트와 화면비, 해상도를 전송——구도, 조명, 이미지 내 타이포그래피는 모델이 처리합니다.
image_urls에 공개 HTTPS 이미지 URL을 1~10개 전달하면 기존 비주얼 편집, 합성, 리스타일 가능——제품 교체, 배경 변경, 스타일 전이.
resolution을 "2k"로 설정하면 인쇄 품질 렌더링. 1K는 미리보기와 반복 작업에 적합합니다.
모델의 가장 강력한 기능 중 하나——포스터와 사인 속 영어, 중국어, 일본어 등 읽기 쉬운 텍스트 출력.
생성 즉시 task_id 반환. 자신의 속도로 상태를 폴링하고 UI 반응성 유지——긴 HTTP 연결 불필요.
업스트림 라우팅과 무관하게 응답 형식은 안정——consumed_credits, status, 이미지 URL이 정규화되어 반환됩니다.
API 키에서 완성된 이미지 URL까지 3단계.
로그인 후 API Keys 페이지를 열어 서버용 키를 복사. 백엔드에 보관——브라우저 코드에 넣지 마세요.
model "seedream-5-pro", 프롬프트, aspect_ratio, resolution, 선택적 image_urls로 POST /v1/images/generations를 호출. task_id와 estimated_credits를 반환합니다.
GET /v1/images/generations/:task_id를 호출. status가 SUCCESS가 되면 images[0].url을 읽어 표시하거나 저장하세요.
생성과 폴링——두 엔드포인트가 전체 라이프사이클을 커버합니다.
Seedream 5 Pro 작업 생성. 빈 image_urls는 텍스트-이미지, 1~10개 URL은 참조 편집. task_id와 estimated_credits를 포함한 202 응답.
IN_PROGRESS, images[].url이 포함된 SUCCESS, 또는 오류 객체를 포함한 FAILED 반환. 완료 후 consumed_credits도 보고.
400 잘못된 파라미터, 401 잘못된 키, 402 크레딧 부족, 404 작업 없음, 429 레이트 리밋, 503 업스트림 불가. 전체 표는 문서 참조.
| 파라미터 | 값 |
|---|---|
| model | 반드시 "seedream-5-pro"——이 라우트의 유일한 공개 모델. |
| prompt | 텍스트 프롬프트 또는 편집 지시, 1~3000자. |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 중 하나. 기본값 1:1. |
| resolution | "1k"(기본, 9 크레딧) 또는 "2k"(18 크레딧). |
| image_urls | 공개 HTTPS URL 0~10개. 빈 배열 = 순수 텍스트-이미지. |
알 수 없는 파라미터는 400 UNKNOWN_PARAMETER로 거부——계약은 명시적으로 유지됩니다. 전체 스키마는 /docs/images 참조.
Seedance API 크레딧 기반 이미지당 정액 가격. 생성 응답에 estimated_credits, 완료 상태에 consumed_credits 포함.
| 모드 | 크레딧 | 비고 |
|---|---|---|
| 텍스트-이미지 · 1K | 이미지당 9 크레딧 | 기본 해상도——반복 작업과 미리보기용. |
| 텍스트-이미지 · 2K | 이미지당 18 크레딧 | 최종 에셋용 인쇄 품질 출력. |
| 참조 이미지 편집 | 추가 이미지당 +0.8 크레딧 | 첫 참조 이미지는 기본 가격 포함, 2~10번째 이미지는 각 +0.8. |
Seedance API에서 Seedream 5 Pro API를 평가하는 개발자를 위한 답변.
Seedance API는 Seedream 5 Pro를 안정적인 REST 표면 뒤에서 제공——인증, 과금, 응답이 정규화된 상태로 모델의 전체 기능을 사용하고, 프로바이더 자격 증명 관리가 필요 없습니다.
image_urls를 빈 배열로 보내면 텍스트-이미지, 공개 HTTPS 이미지 URL을 1~10개 보내면 참조 편집/합성——같은 엔드포인트가 두 모드를 모두 처리합니다.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. 배치에 맞는 비율을 선택하세요——모델은 자르지 않고 해당 비율로 네이티브하게 구도합니다.
1K당 9 크레딧, 2K당 18. 참조 편집은 두 번째 이미지부터 +0.8 크레딧. estimated_credits로 폴링 전에 비용 확인 가능합니다.
일반적인 1K 작업은 약 15~25초. 2K와 다중 참조 편집은 더 오래 걸립니다. 상태 엔드포인트를 폴링하세요——작업은 설계상 비동기입니다.
아니요——해서도 안 됩니다. Bearer 키는 백엔드에 두고, 서버 측에서 저희 엔드포인트를 호출하고, 클라이언트에는 자체 안전한 라우트만 노출하세요.
네——다국어 이미지 내 텍스트가 강점 중 하나입니다. 포스터, 가격표, 현지화된 광고 크리에이티브에서 읽기 쉬운 텍스트가 나옵니다.
전체 요청 스키마, 응답 예시, 오류 표, 가격 세부 정보는 /docs/images에 있습니다. 이 페이지는 통합 개요입니다.
API 키를 받고, 첫 생성 작업을 제출하고, 오늘 바로 플래그십 이미지 생성을 제품에 연결하세요.