Skip to main content
POST
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.comhttps://toapis.cn 로 바꿔 주세요.
  • ByteDance Seed 팀이 개발한 Seedream 5.0 Pro 고품질 이미지 생성 모델
  • model 파라미터로 doubao-seedream-5-0-pro 모델 선택
  • 파라미터는 Seedream-5.0 과 기본적으로 동일하며, 차이는 Pro 가 1K2K 해상도를 지원한다는 점입니다
  • 텍스트-이미지, 이미지-이미지, 다중 참조 이미지 등 생성 모드를 지원
  • 과금 규칙: 첫 번째 참조 이미지는 무료이고 두 번째 참조 이미지부터 정상 규칙으로 과금됩니다
  • 비동기 작업 관리, 작업 ID로 결과 조회
중요 변경: 더 나은 성능과 비용 제어를 위해 image_urls 에 base64 이미지 데이터를 직접 전달하는 방식을 더 이상 지원하지 않습니다. 먼저 Upload 이미지 API 로 이미지를 업로드해 URL 을 받은 뒤 이 API 를 호출하세요.

Authorizations

string
필수
모든 API 는 Bearer Token 인증이 필요합니다API Key 발급: API Key 관리 페이지 에서 API Key 를 받으세요요청 헤더에 추가하세요:

Body

string
기본값:"doubao-seedream-5-0-pro"
필수
이미지 생성 모델 이름예: "doubao-seedream-5-0-pro"
string
필수
이미지 생성 텍스트 설명
string
기본값:"1:1"
이미지 화면 비율layer_decomposition 을 활성화하면 이 필드는 해상도 프리셋 1K 또는 2K 를 직접 전달하는 용도로 바뀝니다.지원하는 화면 비율:
  • 1:1 - 정사각형(기본값)
  • 4:3 - 가로 4:3
  • 3:4 - 세로 3:4
  • 16:9 - 가로 와이드스크린
  • 9:16 - 세로 긴 이미지
  • 3:2 - 가로 3:2
  • 2:3 - 세로 2:3
  • 21:9 - 울트라 와이드
  • 9:21 - 울트라 톨
integer
기본값:1
생성할 이미지 수범위: 1-10(최소 1장, 최대 10장)기본값: 1주의:
  • 참조 이미지 + 생성 이미지 총수가 15 이하여야 합니다
  • 순수 숫자(예: 1)를 입력하고 따옴표를 붙이지 마세요. 그렇지 않으면 오류가 발생합니다
생성 수량과 참조 이미지 수량에 따라 선차감되며 첫 번째 참조 이미지는 무료입니다
boolean
기본값:false
Seedream 5.0 Pro 전용 레이어 분리 기능을 사용할지 여부입니다.
  • false: 일반 평면 이미지 반환(기본값)
  • true: 배경 이미지와 투명 채널을 가진 여러 개의 독립 PNG 레이어 반환
활성화하면 작업 조회 결과의 각 result.data[] 항목에 z_index 가 추가로 반환되고, 독립 레이어에는 bounding_box, name, description 이 추가로 반환됩니다. 이 파라미터는 Seedream 5.0 Pro 만 지원합니다.
string[]
이미지-이미지 또는 이미지 편집에 사용하는 참조 이미지 URL 목록⚠️ URL 형식만 지원(base64 미지원)
  • 공개적으로 접근 가능한 이미지 URL(http:// 또는 https://)
  • Upload 이미지 API 로 로컬 이미지를 업로드해 URL 받기
제한:
  • 이미지 개수: 1-10장
  • 이미지 형식: jpeg, png
  • 화면 비율(가로/세로) 범위: [1/3, 3]
  • 가로와 세로(px) > 14
  • 크기: 10MB 이하
  • 총 픽셀: 6000×6000 px 이하
과금 설명:
  • 첫 번째 참조 이미지 무료
  • 두 번째 참조 이미지부터 정상 규칙으로 과금
object
Seedream 5.0 Pro 모델의 고급 설정을 전달하는 채널 전용 파라미터

응답

string
상태 조회에 사용하는 작업 고유 식별자
string
객체 유형, 항상 generation.task
string
사용한 모델 이름
string
작업 상태
  • queued - 처리 대기 중
  • in_progress - 처리 중
  • completed - 성공적으로 완료
  • failed - 실패
integer
작업 진행률(0-100)
integer
작업 생성 타임스탬프(Unix 타임스탬프)
object
작업 메타데이터
integer
작업 완료 타임스탬프(Unix 타임스탬프). 작업이 완료된 뒤에만 반환됩니다.
integer
결과 파일 만료 타임스탬프(Unix 타임스탬프). 만료 전에 결과 파일을 다운로드하거나 다른 곳에 저장하세요.
object
작업 성공 후의 생성 결과. statuscompleted 일 때만 반환됩니다.
string
결과 유형, 이미지 작업은 항상 image 입니다.
array
이미지 결과 목록. 레이어 분리를 활성화하면 첫 번째 요소가 보통 배경 이미지이고 나머지 요소가 투명 채널을 가진 독립 PNG 레이어입니다.
string
배경 이미지 또는 독립 레이어의 공개 접근 주소입니다.
integer
레이어 적층 순서. layer_decomposition 을 활성화하면 배경 이미지가 보통 0 이고 독립 레이어가 순서대로 증가합니다.
string
현재 배경 이미지 또는 독립 레이어의 픽셀 크기입니다. 예: 2048x2048.
string
현재 결과 항목의 파일 형식입니다. 배경 이미지는 요청한 형식일 수 있고 투명 독립 레이어는 png 입니다.
object
배경 이미지에서 독립 레이어의 위치이며 absolute 절대 좌표와 normalized 정규화 좌표를 포함합니다.
array
배경 이미지에서 레이어의 절대 픽셀 좌표로 [x1, y1, x2, y2] 형식이며 각각 좌측 상단과 우측 하단 좌표를 나타냅니다.
array
레이어의 정규화 좌표로 [x1, y1, x2, y2] 형식이며 좌표 범위는 0-1000 입니다.
string
레이어 이름입니다.
string
레이어 내용 설명입니다.