Seedream 5 Pro API 가이드

AI 이미지 생성을 위한 Seedream 5 Pro API

Seedream 5 Pro는 ByteDance의 플래그십 이미지 모델——다국어 이미지 내 텍스트 렌더링, 다중 참조 편집, 깔끔한 포토리얼 출력에 강합니다. Seedance API에서는 안정적인 별칭으로 간단한 REST 엔드포인트와 비동기 작업 폴링으로 호출합니다.

해상도
1K / 2K

1K 또는 2K 출력

화면비
7

1:1, 16:9, 9:16, 2:3, 3:2 등

입력
T2I + I2I

프롬프트 또는 최대 10장의 참조 이미지

인터페이스
REST

HTTPS 기반 JSON

시작 요청

Seedream 5 Pro 이미지 작업 생성

seedream-5-pro
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을 읽으세요.

Seedream 5 Pro API를 통합하는 이유

프로바이더 SDK나 예기치 않은 스키마 변경 없이, 플래그십 품질의 이미지 모델을 예측 가능한 REST 표면 뒤에 두고 싶은 팀이 선택합니다.

플래그십 출력 품질

Seedream 5 Pro는 포토리얼한 장면, 에디토리얼 제품 사진, 정확한 이미지 내 텍스트를 1K/2K로 렌더링——GPT Image, NanoBanana와 동급입니다.

하나의 안정적인 모델 별칭

model "seedream-5-pro"만 호출하면 됩니다. 프로바이더 라우팅, 용량, 폴백은 저희 쪽에서 처리——업스트림 변경에 통합이 영향받지 않습니다.

예측 가능한 크레딧 가격

1K 이미지당 9 크레딧, 2K당 18, 두 번째 참조 이미지부터 +0.8. estimated_credits가 생성 응답에 포함됩니다.

Seedream 5 Pro API 기능

공개 인터페이스는 모델이 실제로 하는 일을 그대로 제공: 텍스트-이미지 생성과 최대 10장의 참조 이미지 편집.

텍스트-이미지 생성

최대 3000자의 프롬프트와 화면비, 해상도를 전송——구도, 조명, 이미지 내 타이포그래피는 모델이 처리합니다.

다중 참조 편집

image_urls에 공개 HTTPS 이미지 URL을 1~10개 전달하면 기존 비주얼 편집, 합성, 리스타일 가능——제품 교체, 배경 변경, 스타일 전이.

2K 고해상도 출력

resolution을 "2k"로 설정하면 인쇄 품질 렌더링. 1K는 미리보기와 반복 작업에 적합합니다.

다국어 이미지 내 텍스트

모델의 가장 강력한 기능 중 하나——포스터와 사인 속 영어, 중국어, 일본어 등 읽기 쉬운 텍스트 출력.

비동기 작업 아키텍처

생성 즉시 task_id 반환. 자신의 속도로 상태를 폴링하고 UI 반응성 유지——긴 HTTP 연결 불필요.

프로바이더 독립적 응답

업스트림 라우팅과 무관하게 응답 형식은 안정——consumed_credits, status, 이미지 URL이 정규화되어 반환됩니다.

Seedream 5 Pro API 호출 방법

API 키에서 완성된 이미지 URL까지 3단계.

1

API 키 생성

로그인 후 API Keys 페이지를 열어 서버용 키를 복사. 백엔드에 보관——브라우저 코드에 넣지 마세요.

2

생성 작업 제출

model "seedream-5-pro", 프롬프트, aspect_ratio, resolution, 선택적 image_urls로 POST /v1/images/generations를 호출. task_id와 estimated_credits를 반환합니다.

3

폴링 후 렌더링

GET /v1/images/generations/:task_id를 호출. status가 SUCCESS가 되면 images[0].url을 읽어 표시하거나 저장하세요.

엔드포인트 레퍼런스

생성과 폴링——두 엔드포인트가 전체 라이프사이클을 커버합니다.

POST /v1/images/generations

Seedream 5 Pro 작업 생성. 빈 image_urls는 텍스트-이미지, 1~10개 URL은 참조 편집. task_id와 estimated_credits를 포함한 202 응답.

GET /v1/images/generations/:task_id

IN_PROGRESS, images[].url이 포함된 SUCCESS, 또는 오류 객체를 포함한 FAILED 반환. 완료 후 consumed_credits도 보고.

오류와 한도

400 잘못된 파라미터, 401 잘못된 키, 402 크레딧 부족, 404 작업 없음, 429 레이트 리밋, 503 업스트림 불가. 전체 표는 문서 참조.

요청 파라미터

파라미터값
model반드시 "seedream-5-pro"——이 라우트의 유일한 공개 모델.
prompt텍스트 프롬프트 또는 편집 지시, 1~3000자.
aspect_ratio1: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.

Seedream 5 Pro API FAQ

Seedance API에서 Seedream 5 Pro API를 평가하는 개발자를 위한 답변.

이것은 ByteDance 공식 Seedream 5 Pro API인가요?

Seedance API는 Seedream 5 Pro를 안정적인 REST 표면 뒤에서 제공——인증, 과금, 응답이 정규화된 상태로 모델의 전체 기능을 사용하고, 프로바이더 자격 증명 관리가 필요 없습니다.

텍스트-이미지와 참조 편집의 차이는?

image_urls를 빈 배열로 보내면 텍스트-이미지, 공개 HTTPS 이미지 URL을 1~10개 보내면 참조 편집/합성——같은 엔드포인트가 두 모드를 모두 처리합니다.

Seedream 5 Pro는 어떤 화면비를 지원하나요?

1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2. 배치에 맞는 비율을 선택하세요——모델은 자르지 않고 해당 비율로 네이티브하게 구도합니다.

Seedream 5 Pro 이미지 한 장의 비용은?

1K당 9 크레딧, 2K당 18. 참조 편집은 두 번째 이미지부터 +0.8 크레딧. estimated_credits로 폴링 전에 비용 확인 가능합니다.

생성에 얼마나 걸리나요?

일반적인 1K 작업은 약 15~25초. 2K와 다중 참조 편집은 더 오래 걸립니다. 상태 엔드포인트를 폴링하세요——작업은 설계상 비동기입니다.

브라우저에서 이 API를 호출할 수 있나요?

아니요——해서도 안 됩니다. Bearer 키는 백엔드에 두고, 서버 측에서 저희 엔드포인트를 호출하고, 클라이언트에는 자체 안전한 라우트만 노출하세요.

Seedream 5 Pro는 이미지 안에 텍스트를 렌더링하나요?

네——다국어 이미지 내 텍스트가 강점 중 하나입니다. 포스터, 가격표, 현지화된 광고 크리에이티브에서 읽기 쉬운 텍스트가 나옵니다.

전체 API 문서는 어디에 있나요?

전체 요청 스키마, 응답 예시, 오류 표, 가격 세부 정보는 /docs/images에 있습니다. 이 페이지는 통합 개요입니다.

첫 Seedream 5 Pro 이미지 만들기

API 키를 받고, 첫 생성 작업을 제출하고, 오늘 바로 플래그십 이미지 생성을 제품에 연결하세요.