메인 콘텐츠로 건너뛰기
POST
Seedream 5.5 Pro · 이미지-이미지

소개

참조 이미지와 편집 지시문으로 단일 이미지 편집, 다중 이미지 융합, 대화형 편집, 투명 이미지 또는 레이어 분해를 수행합니다. 일반 편집은 이미지 1장을, 분해는 기본 이미지와 여러 레이어를 반환합니다. 정형 인쇄 텍스트 레이어에는 서식 있는 텍스트 OCR 결과도 반환할 수 있습니다.

엔드포인트 및 인증

Authorization: Bearer sk-xxxxxxxxxx와 Content-Type: application/json을 사용하세요. 이미지 편집은 같은 JSON 본문으로 /v1/images/edits도 사용할 수 있습니다. 매개변수 및 요금

요청 매개변수

일반 생성에서 n은 생략하거나 1을 사용하고, 결과가 여러 장 필요하면 요청을 각각 보내세요. 공통 매개변수에서 전체 기본값과 safety_identifier를 확인하세요. 두 모델 모두 quality, 연속 이미지 생성, 스트리밍 및 웹 검색을 지원하지 않습니다.

prompt

편집 시 필수입니다. 참조 이미지를 어떻게 사용하거나 변경할지 설명하세요. 분해 시에는 선택 사항이며 분리할 요소를 지정하거나 생략하여 모델이 주요 요소를 자동 인식하게 할 수 있습니다. 중국어는 300자, 영어는 600단어 이내를 권장하며 너무 길면 세부 사항이 누락될 수 있습니다. 대화형 편집에서는 왼쪽 위를 원점으로 하는 정규화 좌표 [0, 1000]과 <bbox>x1 y1 x2 y2</bbox>로 영역을 지정하세요. 참조 이미지에 상자, 화살표 또는 스케치를 그린 뒤 변경 사항을 설명할 수도 있습니다.

image

문자열 1개 또는 문자열 배열을 받습니다. 각 항목은 서버에서 접근할 수 있는 공개 URL 또는 data:image/<format>;base64,<data> 형식의 Base64 데이터 URI입니다. 형식 이름은 소문자를 사용하세요(예: data:image/png;base64,iVBORw0...).
총 픽셀 수는 가로 × 세로의 곱이며 각 변의 최솟값을 뜻하지 않습니다. 투명 이미지 조건은 아래에 별도로 설명합니다.

size

전체 크기 규칙과 해상도 표 분해는 1K, 1.5K, 2K, auto(기본값)만 지원하며 사용자 지정 픽셀 크기는 지원하지 않습니다.

background

텍스트-이미지와 이미지-이미지 모두 네이티브 투명 이미지를 지원합니다. 편집 시 알파 채널이 없는 참조 이미지도 최대 10장까지 사용할 수 있습니다. 실제 투명도는 요청값과 다를 수 있으므로 data[].background를 확인하세요.
background: "transparent"와 JPEG 출력을 함께 사용하지 마세요. 레이어 분해 모드에서는 background를 전달하지 마세요.

layer_decomposition

layer_decomposition: true로 이미지 1장을 기본 이미지 1장과 알파 채널을 가진 독립 PNG 레이어 최대 99개로 분해합니다. 기본값은 false입니다.
  • image는 필수이며 입력은 정확히 1장이어야 합니다.
  • 레이어 하나라도 실패하면 전체 요청이 실패하며 부분 성공은 지원하지 않습니다.
  • 요청한 레이어가 상한을 넘으면 일부 정보가 누락될 수 있습니다.
  • 응답에는 z_index, name, description, bounding_box가 포함됩니다.
  • 기본 이미지와 모든 레이어는 usage.generated_images에 포함됩니다.

layer_decomposition_options

layer_decomposition이 true일 때만 적용됩니다.
지시문이 없거나 모호하면 모델이 이미지 복잡도와 max_images에 따라 분해를 계획합니다. 상한이 클수록 보통 더 세밀하게 분해됩니다. 업스트림은 max_images 기준으로 IPM(분당 이미지 수) 한도를 예약하고 미사용분을 해제합니다. 비텍스트 레이어와 손글씨, 장식 문자 등 비정형 텍스트는 OCR을 반환하지 않습니다. 지원 글꼴: Seedream 5.5 OCR 글꼴

호출 예제

각 예제는 전체 JSON 본문과 동일한 cURL을 제공합니다. sk-xxxxxxxxxx를 자신의 API 키로 바꾸세요. 입력 URL은 로그인 없이 접근할 수 있는 공개 주소입니다. 응답 URL은 구조 예시입니다.

단일 이미지 편집

다중 이미지 융합

대화형 편집

투명 이미지 편집

레이어 분해 및 OCR

자동 레이어 분해

prompt를 생략하면 주요 요소를 자동으로 인식하고 분해합니다. 기본값은 size: "auto", max_images: 30입니다.

성공 응답

일반 편집은 공통 응답 형식을 사용하며 usage.input_images는 실제 참조 이미지 수입니다. 아래는 기본 이미지와 레이어 1개만 발췌한 예시이며 usage는 전체 결과 기준입니다. 따라서 generated_images는 표시된 항목 수보다 큽니다. URL은 구조 예시입니다. 공통 응답

응답 필드

공통 응답 필드

text_recognition

스타일은 자동 인식되므로 원본의 정확한 속성과 차이가 있을 수 있습니다.
레이어 복원: 절대 좌표를 사용하여 레이어를 (right - left) × (bottom - top) 크기로 조정한 뒤 기본 이미지의 (left, top) 위치에 놓으세요. 정규화 좌표를 W × H 캔버스에 적용하면 왼쪽 위 위치는 (left / 1000 × W, top / 1000 × H)입니다. z_index가 작은 순서부터 쌓으세요.
결과 URL은 24시간 후 만료되므로 즉시 다운로드하여 저장하세요.

요금 및 오류 처리

참조 이미지와 출력 이미지는 별도로 과금되며 기본 이미지와 각 레이어는 개별 출력으로 계산합니다. 요금 · 오류 처리