Skip to main content
POST
Image Editing / Multi-image Fusion / Batch Sequence
하나의 엔드포인트, 여러 모드: Seedream에는 별도의 /v1/images/edits 엔드포인트가 없습니다. 편집, 다중 이미지 융합, 배치 시퀀스는 모두 POST /v1/images/generations를 통해 실행됩니다. 이 페이지의 Playground는 Text-to-Image와 동일한 엔드포인트를 사용하며, 차이는 본문에 있는 imagesequential_image_generation 파라미터뿐입니다.
모드:
  • 단일 이미지 편집image: ["url"] + sequential_image_generation: "disabled"
  • 다중 이미지 융합image: ["url1", "url2", ...] + disabled
  • 배치 시퀀스sequential_image_generation: "auto" + sequential_image_generation_options.max_images: N
  • 이미지-시퀀스 — 두 가지를 결합합니다: image 배열 + auto + max_images
🖥️ 브라우저 Playground 제한 (b64_json 모드만 해당)기본 response_format: "url" 모드에서는 Playground가 정상적으로 작동합니다(응답은 임시 BytePlus TOS 링크일 뿐입니다). response_format: "b64_json"로 전환하면 응답에 수 MB의 base64 문자열이 포함되어 브라우저 Playground에 请求时发生错误: unable to complete request가 표시될 수 있습니다 — 실제로 요청은 성공한 것입니다; 브라우저가 이렇게 긴 base64 문자열을 렌더링하지 못할 뿐입니다.권장 작업 흐름:
  • 이미지만 보고 싶으신가요? 기본 url 모드를 유지하십시오 — Playground가 링크를 직접 반환합니다(24시간 이내에 자체 저장소로 다운로드해야 합니다).
  • b64_json이 필요하신가요? 아래 코드 샘플을 복사하여 로컬에서 실행하십시오 — 코드는 이미지를 자동으로 디코딩하여 파일로 저장합니다.
⚠️ OpenAI gpt-image-2 편집과의 주요 차이점
  • multipart/form-data 업로드는 없습니다 — 먼저 이미지를 OSS 또는 공개 이미지 호스트에 업로드한 다음, image 배열에 URL을 전달하십시오
  • image는 URL 배열이며, 반복되는 image[] 필드가 아닙니다(OpenAI의 multipart/form-data 형식과는 다릅니다)
  • mask 필드가 없습니다 — Seedream은 알파 채널 마스크 인페인팅을 지원하지 않으며, 전체 이미지는 프롬프트에 의해 다시 작성됩니다
  • 총 개수의 하드 제한: 입력 참조 + 출력 ≤ 15개 이미지
📎 다중 이미지 순서는 중요합니다image 배열에 있는 URL의 순서가 프롬프트에서 참조하는 「이미지 1 / 이미지 2 / 이미지 3」이 됩니다. 순서를 명시적으로 지정하십시오:
이미지 1의 의상을 이미지 2의 복장으로 바꾸고, 이미지 3의 조명을 유지하십시오.
영어 프롬프트가 가장 잘 작동합니다(모델은 주로 영어로 학습되었습니다). 다만 표현이 모호하지 않다면 중국어도 지원됩니다.

코드 예시

extra_body에 대하여(중요 — 추가 중첩 계층이라고 오해하지 마십시오)image, sequential_image_generation, watermark는 OpenAI SDK의 images.generate()에 대한 표준 매개변수가 아니므로, Python SDK에서는 전송하려면 반드시 extra_body 안에 넣어야 합니다.하지만 extra_body는 단지 SDK의 매개변수 컨테이너일 뿐입니다. 그 필드들은 요청 본문의 최상위로 평탄화되어 병합되며, modelprompt동일한 수준에 있습니다. 실제로 전송되는 JSON은 아래 cURL 예시와 동일하며(image가 최상위에 있음), 요청에는 실제 "extra_body": {...} 중첩이 없습니다.OpenAI SDK를 사용하지 않고 JSON을 직접 구성하는 경우(requests / fetch / 등), extra_body를 작성하지 마십시오. image와 다른 필드들을 model와 같은 수준에 두기만 하면 됩니다.

Python (OpenAI SDK · 단일 이미지 편집)

Python (OpenAI SDK · 다중 이미지 융합)

Python (OpenAI SDK · 배치 순서)

cURL (다중 이미지 융합)

Node.js (fetch · 배치 순서)

매개변수 참조

다중 이미지 및 시퀀스 모드의 개수 제약

반복적 정제: 이전 출력의 URL을 다음 입력으로 넣고, 새 편집 지시와 함께 제공하여 점진적으로 정제합니다. 각 라운드는 이미지당 과금되므로 누적 비용에 유의하십시오.

응답 형식

⚠️ data 배열 길이는 실제 출력 개수를 반영합니다
  • sequential_image_generation: "disabled" → 단일 요소 data
  • sequential_image_generation: "auto" + max_images: N → 일반적으로 N개 요소입니다(프롬프트가 더 적은 결과를 생성하면 경우에 따라 더 적을 수 있습니다)
  • 과금은 usage.generated_images 기준이며, max_images 기준이 아닙니다
편집 요청은 텍스트-이미지와 동일하게, 출력 이미지당 과금됩니다. 참조 이미지 입력은 별도로 과금되지 않습니다.

인증

Authorization
string
header
필수

API Key obtained from APIYI Console

본문

application/json
model
enum<string>
기본값:seedream-5-0-260128
필수

Model ID

사용 가능한 옵션:
seedream-5-0-260128,
seedream-5-0-lite-260128,
seedream-4-5-251128,
seedream-4-0-250828,
seedream-5-0-pro-260628
prompt
string
필수

Editing / fusion / sequence instruction. For multi-image scenarios, refer to images explicitly as 'image 1 / image 2'

예시:

"Replace the clothing in image 1 with the outfit from image 2."

image
string<uri>[]

Reference image URL array. Up to 10 images (per official 4.5 docs). Note: input + output count ≤ 15

Maximum array length: 10
예시:
sequential_image_generation
enum<string>
기본값:disabled

Generation mode switch. disabled = single output (default); auto = batch sequence, paired with max_images

사용 가능한 옵션:
disabled,
auto
sequential_image_generation_options
object

Batch sequence options. Effective only when sequential_image_generation=auto

size
string
기본값:2K

Output size. Preset tiers (vary by version):

  • 1K (4.0 only) / 2K (all) / 3K (5.0 only) / 4K (4.5, 4.0)

Or exact pixel size WxH, total pixels ∈ [1280×720, 4096×4096], aspect ratio ∈ [1/16, 16]

예시:

"2K"

response_format
enum<string>
기본값:url
사용 가능한 옵션:
url,
b64_json
output_format
enum<string>
기본값:jpeg

Output format. 5.0 supports png/jpeg; 4.5/4.0 only jpeg

사용 가능한 옵션:
png,
jpeg
watermark
boolean
기본값:false
stream
boolean
기본값:false

Streaming output. Recommended for long prompts and multi-image sequence scenarios

응답

Edited image generated successfully

model
string
예시:

"seedream-5-0-260128"

created
integer
예시:

1768518000

data
object[]

Result array. disabled mode returns 1 element; auto mode typically returns max_images elements (may be fewer)

usage
object

Billed by generated_images actual count, NOT by max_images