Skip to main content
POST

인증

string
필수
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지를 방문하여 API 키를 받으세요요청 헤더에 추가:

Body

string
기본값:"seedream-4.0"
필수
이미지 생성 모델 이름지원 모델: seedream-4.0, seedream-4-0, Seedream-4.0Example: "seedream-4.0"
boolean
기본값:"false"
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
이미지 생성을 위한 텍스트 설명최대 1000자
string
기본값:"1:1"
이미지 가로세로 비율지원되는 가로세로 비율:
  • 1:1 - 정사각형 (기본값)
  • 4:3 - 가로 4:3
  • 3:4 - 세로 3:4
  • 16:9 - 가로 와이드스크린
  • 9:16 - 세로
  • 3:2 - 가로 3:2
  • 2:3 - 세로 2:3
  • 2:1 - 가로형 긴 비율
  • 1:2 - 세로형 긴 비율
  • 21:9 - 울트라 와이드
  • 9:21 - 울트라 톨
  • auto - 참조 이미지 비율 자동 매칭 (image_urls 필요)
2x12:1, 1x21:2와 같습니다. x는 소문자여야 하며 공백은 허용되지 않습니다.
string
기본값:"2K"
이미지 해상도지원되는 해상도:
  • 1K - 기본 해상도
  • 2K - 표준 해상도 (기본값)
  • 4K - 고해상도
해상도 참고 크기:
integer
생성할 이미지 수범위: 1-15 (최소 1장, 최대 15장)기본값: 1참고:
  • 순수한 숫자를 입력하세요(예:1)。인용부호를 사용하면 오류가 발생합니다
수량에 따라 요금이 사전 차감됩니다
image_urls의 참조 이미지 수 + n으로 지정한 최종 생성 이미지 수는 ≤ 15장이어야 합니다.
array
이미지 간 변환 또는 이미지 편집을 위한 참조 이미지 URL 목록두 가지 형식 지원:1. 완전한 이미지 URL
  • 공개적으로 접근 가능한 이미지 URL (http:// 또는 https://)
  • 예: https://example.com/image.jpg
2. Base64 인코딩 형식
  • 완전한 Data URI 형식을 사용해야 합니다
  • 형식: data:image/{형식};base64,{base64 데이터}
  • 지원되는 이미지 형식: jpeg, png
  • 예: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 주의: data:image/jpeg;base64, 접두사를 포함해야 합니다
제한:
  • 이미지 형식: jpeg, png
  • 가로세로 비율(너비/높이) 범위: [1/3, 3]
  • 너비 및 높이(px) > 14
  • 크기: 10MB 이하
  • 총 픽셀: 6000×6000 px 이하
image_urls의 참조 이미지 수 + n으로 지정한 최종 생성 이미지 수는 ≤ 15장이어야 합니다.
string
기본값:"standard"
프롬프트 최적화 모드
  • standard:표준 모드, 더 높은 품질의 콘텐츠를 생성하지만 처리 시간이 더 깁니다
  • fast:빠른 모드, 처리 시간이 짧고 일반적인 품질의 콘텐츠를 생성합니다
기본값:standard
string
기본값:"disabled"
연속 이미지 생성 모드 (Doubao 전용 기능)여러 이미지를 생성할지 여부를 제어합니다:
  • disabled: 연속 모드 비활성화, 여러 참조 이미지가 있어도 1장만 생성 (기본값)
  • auto: 연속 모드 활성화, 여러 이미지 생성 가능
사용 방법:
  • image_urls 제공 필수 - 최소 1장의 참조 이미지 필요
  • n: 3 설정 또는 sequential_image_generation: "auto" + max_images: 3 사용
  • ✅ 이렇게 하면 참조 이미지를 기반으로 3장의 다른 이미지가 생성됩니다
  • ⚠️ n > 1인 경우 자동으로 auto로 설정됩니다
제한 사항:
  • 순수 텍스트-이미지 변환 (image_urls 없음)에서는 여러 이미지를 생성할 수 없습니다 - 이것은 Doubao API의 제한입니다
object
연속 이미지 생성 옵션sequential_image_generationauto로 설정된 경우 사용 가능속성:
  • max_images (integer): 생성할 이미지 수 지정, 범위: 1-15
예시:
boolean
기본값:"false"
생성된 이미지에 워터마크를 추가할지 여부
  • true: 워터마크 추가
  • false: 워터마크 없음 (기본값)

Response

integer
응답 상태 코드
array
응답 데이터 배열