Skip to main content
POST

인증

string
필수
모든 API 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지를 방문하여 API 키를 받으세요요청 헤더에 추가:
단일 이미지 모델: seedream-5-0-pro는 요청당 1장의 이미지만 생성합니다(레이어 분해 제외). 다음 매개변수는 거부됩니다(HTTP 400, 작업 미생성, 비용 미청구):
  • n > 1
  • sequential_image_generation(그룹 생성 미지원)
  • stream(스트리밍 미지원)
  • tools(웹 검색 미지원)
  • image_urls가 10개를 초과

인터랙티브 편집

프롬프트에 <point> / <bbox> 좌표를 사용하거나 손으로 표시한 이미지를 업로드하여 편집 위치를 정확하게 지정합니다.
  • 점 좌표: <point>x y</point> (하나의 점을 지정하며 영향 범위는 모델이 판단합니다)
  • 경계 상자 좌표: <bbox>x1 y1 x2 y2</bbox> (왼쪽 위와 오른쪽 아래 좌표를 지정하여 편집 영역의 크기를 정밀하게 제어합니다)

레이어 분해

하나의 이미지를 베이스 이미지와 최대 16개의 투명 PNG 레이어로 분리하고 위치와 쌓임 순서 정보를 반환합니다.

Body

string
기본값:"seedream-5-0-pro"
필수
이미지 생성 모델 이름
  • seedream-5-0-pro (권장)
  • 허용 별칭: seedream-5.0-pro
boolean
기본값:"false"
이미지 작업을 제출하기 전에 콘텐츠 검토를 실행할지 여부를 지정합니다.
  • true: omni-moderation-latest로 프롬프트와 입력 이미지를 검토
  • false 또는 생략: 검토 요청을 보내지 않으며 검토 비용이나 지연이 추가되지 않음(기본값)
string
필수
이미지 생성을 위한 텍스트 설명layer_decomposition: true인 경우 선택 사항입니다. 생략하면 모델이 이미지의 주요 요소를 자동으로 인식하고 분리합니다.중국어와 영어 외에 러시아어, 아랍어, 필리핀어, 태국어, 터키어, 한국어, 말레이어, 스페인어, 포르투갈어, 인도네시아어, 프랑스어, 독일어, 베트남어, 일본어의 네이티브 텍스트 생성을 지원합니다.
팁: 영어 600단어 이내로 유지하세요. 설명이 너무 길면 세부 사항이 손실될 수 있습니다.
string
기본값:"1K"
해상도 등급(소문자 허용). 등급을 size에 직접 입력하는 것과 동일한 API Mart 확장 필드입니다.
  • 1K (기본값)
  • 1.5K (1K와 동일 가격, 더 나은 품질 — 특별한 이유가 없으면 1.5K 권장)
  • 2K
3K / 4K 등 미지원 단계는 400을 반환합니다.등급 형식의 sizeresolution을 모두 제공하면 size가 우선합니다.
size정확한 픽셀 값(예: 2048x1024)이면 이 필드는 무시되며 치수는 size만으로 결정됩니다.
string
기본값:"auto"
등급 키워드, 화면비, auto 또는 정확한 픽셀 크기.

형식 ①: 해상도 등급(권장)

등급을 size에 직접 입력하거나 API Mart 확장 필드 resolution으로 제공할 수 있습니다:
두 형식은 동일합니다. 등급만 지정할 때는 프롬프트에 원하는 레이아웃(예: “세로형 포스터”, “가로형 커버”)을 설명하고 모델이 화면비를 선택하게 하십시오.

형식 ②: 등급 + 화면비

resolution과 함께 사용. 지원 비율:
  • 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9
  • 16x9 형태의 x 구분도 허용
  • 2x12:1, 1x21:2와 같습니다. x는 소문자여야 하며 공백은 허용되지 않습니다.
  • auto (기본값): 해상도 단계만 적용; 최종 종횡비는 prompt / 참조 이미지에서 결정
목록 밖의 비율(예: 9:21)은 400 — 1:1로 조용히 대체되지 않음.단계 × 비율 → 출력 픽셀:

형식 ③: 정확한 픽셀

sizewidthxheight이면 픽셀이 그대로 사용되고 resolution은 적용되지 않습니다. 2048X1024 / 2048×1024 허용.
제한은 너비와 높이의 에 적용되며, 각 변 단독이 아닙니다. 예: 512×512는 너무 작음(400); 2048×1024는 유효.
string
기본값:"opaque"
출력 배경 모드:
  • opaque: 불투명 배경(기본값)
  • transparent: 투명 배경
transparent는 알파 채널이 이미 있는 입력 이미지 1장을 사용하는 이미지-이미지 요청에서만 사용할 수 있으며 output_format: "png"도 필요합니다.
boolean
기본값:"false"
이미지를 레이어로 분해할지 여부입니다. 활성화하면 모델이 베이스 이미지 1장과 최대 16개의 알파 채널 PNG 레이어를 반환합니다.PNG 또는 JPEG 이미지 1장이 필요합니다. 총 픽셀 수는 [262144, 36000000], 파일 크기는 30 MB 이하여야 합니다. size1K, 1.5K, 2K, auto만 허용하며 기본값은 auto입니다. output_format은 베이스 이미지 형식만 제어하고, 분해된 레이어는 항상 PNG입니다.
object
기본값:"{\"mode\":\"standard\"}"
프롬프트 최적화 모드:
  • standard: 더 나은 품질의 표준 모드(기본값)
평면 형식 "optimize_prompt_options.mode": "standard"도 허용됩니다.
integer
기본값:"1"
생성할 이미지 수입니다. 1만 지원하며, 그룹 이미지 생성에는 seedream-5-0-lite를 사용하십시오.
array
참조 이미지 URL 목록. 단일 / 다중 참조 image-to-image용, 최대 10장두 가지 형식:1. 공개 URL
  • http:// 또는 https://
  • 예: https://example.com/image.jpg
2. Base64 (Data URI)
  • 형식: data:image/<format>;base64,<data><format>소문자 필수
  • 예: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
이미지당 제한:
  • 형식: jpeg / png / webp / bmp / tiff / gif / heic / heif
  • 종횡비 (w/h): [1/16, 16]
  • 각 변 > 14 px
  • 크기 ≤ 30 MB
  • 총 픽셀 ≤ 6000×6000 (36,000,000)
요금: 첫 번째 참조 이미지는 무료; 추가 이미지마다 고정 추가 요금.
string
기본값:"jpeg"
출력 이미지 형식
  • jpeg (기본값)
  • png
호환: response_formatoutput_format과 동일; 기타 값은 jpeg로 처리.
boolean
기본값:"false"
오른쪽 하단에 “AI generated” 워터마크를 추가할지 여부
  • true: 워터마크 추가
  • false: 없음 (기본값)

요청 예제

텍스트-이미지 (단계 + 비율)

텍스트-이미지 (정확한 픽셀)

다중 참조

권장: 1.5K 동일 가격, 더 나은 품질

레이어 분해

0–1000으로 정규화된 <bbox> 좌표를 사용해 추출할 요소를 정확하게 지정할 수도 있습니다:

인터랙티브 편집

이미지의 손그림 표시를 자연어로 설명합니다:
또는 <point> / <bbox>로 위치를 정확하게 지정합니다:

알파 채널 편집

전체 예시: 작업 제출 및 이미지 가져오기

다음 스크립트는 비동기 작업 제출, 상태 폴링, 실패 상태 처리, 최종 이미지 URL 읽기의 전체 흐름을 보여 줍니다. 실행 전 YOUR_API_KEY를 교체하십시오.
Python
성공하면 작업 조회 엔드포인트가 다음을 반환합니다:
반환된 이미지는 플랫폼이 관리하는 저장소에 미러링됩니다. 그래도 즉시 다운로드하여 자체 시스템에 영구 저장하고, 결과 URL을 영구 저장소로 간주하지 마십시오.

전체 cURL 시나리오

다중 이미지 합성(최대 10개 참조)

정확한 픽셀, 프롬프트 최적화, 워터마크

투명 레이어를 분해하여 독립적으로 편집

먼저 원본 이미지를 분해합니다:
다음으로 투명 레이어의 URL을 가져와 독립적으로 편집합니다:

레이어 분해 응답 및 재구성

url, sizes, output_formats, layers 배열은 인덱스별로 서로 대응하며, 인덱스 0은 항상 베이스 이미지입니다:
z_index 오름차순으로 레이어를 합성합니다. 절대 좌표로 출력 베이스 이미지에 재구성하려면:
임의의 W × H 캔버스에 재구성하려면 정규화 좌표를 사용합니다:
레이어 분해는 이미지별로 과금됩니다. 작업 제출 시 최대 17장을 사전 승인합니다. 완료 후 각 출력을 실제 픽셀 수에 따라 등급 판정하여 개별 정산하고, 초과 사전 승인액은 자동 환불합니다. 잔액은 17장의 사전 승인을 충당해야 하며 size: "auto"는 2K 등급으로 사전 승인됩니다.

요금 안내

출력은 실제 총 픽셀 기준으로 구분합니다(약 2.61M = 2,601,124):
  • 1.5K는 1K와 동일 요금($0.045).
  • size가 정확 픽셀일 때 과금은 실제 출력 면적 기준이며 resolution은 영향을 주지 않습니다(예: size: "2048x2048" → $0.09).
  • 참조 이미지 1장은 무료, 2장부터 가산.
  • 작업 실패 시 전액 자동 환불.

레이어 분해 사전 승인 및 정산

작업 제출 시 최종 레이어 수와 크기를 알 수 없으므로, 요청에 기반한 보수적 규칙으로 사전 승인합니다:
  • 정확한 픽셀: 요청한 픽셀 면적으로 등급 판정.
  • 1K / 1.5K: 1K 등급으로 사전 승인.
  • 2K: 2K 등급으로 사전 승인.
  • auto: 최대 2K로 출력할 수 있으므로 2K 등급으로 사전 승인.
완료 후 베이스 이미지와 실제 각 레이어를 실제 픽셀 면적으로 개별 등급 판정하여 합산합니다. 초과 사전 승인액은 자동 환불됩니다. 레이어는 보통 베이스 이미지보다 훨씬 작으므로, 2K 등급으로 사전 승인된 작업도 최종적으로 전부 1K 등급으로 정산될 수 있습니다.
예: 1080×1080 입력이 10장으로 분해되면 17장 × 2K 등급으로 사전 승인합니다. 최종 10장이 모두 261만 픽셀 이하라면 10장 × 1K 등급으로 정산하고 나머지 크레딧은 자동 환불합니다.

자주 발생하는 오류

⏱️ 느린 생성: 1K는 약 90초, 2K는 약 160초(품질 우선). 5〜10초마다 작업 상태 가져오기를 폴링하고 클라이언트 타임아웃을 5분으로 설정하십시오. 생성 결과를 즉시 저장하십시오.

응답

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