종료까지—Wan 모델 공식 가격 대비 최대 45% 할인
LogoWan API
  • 모델
  • 개발자
  • 요금
  • API 문서
  • 가이드
Seedream 5.5 API 튜토리얼: 이미지 생성·편집·분리
2026. 11. 12.

Seedream 5.5 API 튜토리얼: 이미지 생성·편집·분리

Seedream 5.5를 한 번 호출하고 작업을 폴링합니다. 참조 편집, 투명 PNG, 레이어 분리 방법과 출력 크기 및 실시간 이미지 요금을 확인합니다.

Seedream 5.5는 이미지보다 먼저 작업 ID를 반환합니다. 요청을 한 번 제출하고 ID를 저장한 뒤 완성된 결과를 폴링합니다. 생성은 이미지 한 개를 만들며, 레이어 분리는 기본 이미지와 투명 레이어를 만들 수 있습니다. 두 워크플로 모두 model: "seedream-5-5"를 사용하지만 입력 규칙은 다릅니다. 1

이 튜토리얼은 도자기 찻주전자 설명으로 생성과 특정 부분 편집을 진행한 뒤 기존 포스터를 레이어로 분리하는 방법을 보여 줍니다. Seedream 5.5 Playground에서도 같은 요청 설정을 제공합니다. 애플리케이션에 추가하기 전에 JSON을 확인할 수 있습니다.

규약은 2026년 11월 12일에 확인했습니다. 통합 검사에서는 호환되지 않는 투명도 설정, 레이어 제한, 사용 가능한 치수가 없는 완료 출력 등을 포함한 요청 및 응답 34건을 재현했습니다. 이 검사는 요청 처리와 정산 입력을 검증하며, 생성 속도나 이미지 품질 벤치마크가 아닙니다. 아래 이미지는 11월 10일의 기존 Seedream 5.5 샘플입니다.

키와 작은 요청 하나로 시작하기

API 키에서 키를 만들고 서버에 보관하며, 기본 URL로 https://api.wanapi.app을 사용합니다. 기존 Wan API 키는 사용 가능한 모델과 그룹 모두에서 작동합니다. 이 이미지 모델용 키를 별도로 구매하거나 선택할 필요가 없습니다.

다음을 generate.json으로 저장합니다.

{
  "model": "seedream-5-5",
  "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
  "size": "1K",
  "output_format": "png",
  "content_filter": true
}

서버 환경에 WAN_API_KEY를 설정하고 한 번 제출합니다.

curl --fail-with-body --retry 0 --max-time 90 \
  https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @generate.json \
  -o submitted.json

성공 응답에는 id, model 및 처리 중 상태가 포함됩니다. submitted.json 파일 전체를 보관합니다. 이미지 URL이 없다고 생성 실패로 해석하지 않습니다. 이 응답은 작업이 접수되었음을 알립니다. ID를 받기 전에 연결이 끊기면 다른 POST를 시도하기 전에 작업 로그를 확인합니다. 응답이 불확실하다고 같은 유료 작업을 다시 만들어서는 안 됩니다.

첫 요청에서는 1K를 명시적으로 선택했습니다. size를 생략하면 생성 기본값은 2K입니다. PNG가 기본 형식이며, 워터마크는 꺼져 있고 콘텐츠 검토는 켜져 있습니다. 공개 API 호출자는 content_filter를 명시적으로 변경할 수 있지만, Playground에서는 일반 계정의 검토를 켜진 상태로 유지합니다. 1

새로고침 후에도 저장한 ID 폴링하기

폴링 URL은 GET /seedream55/v1/tasks/{id}입니다. 완료 응답은 이미지를 output.data에 저장하며, 동기 Images API 응답 구조를 사용하지 않습니다. 각 항목에는 URL과 실제 픽셀 크기가 있습니다.

이 Python 스크립트는 저장한 응답을 읽고 최대 10분 동안 폴링합니다. GET 요청만 보내므로 다시 실행해도 기존 작업을 이어서 확인합니다.

import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path

saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600

while time.monotonic() < deadline:
    request = urllib.request.Request(
        url,
        headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            task = json.load(response)
    except urllib.error.HTTPError as error:
        if error.code != 429 and error.code < 500:
            raise
        time.sleep(5)
        continue
    except (urllib.error.URLError, TimeoutError):
        time.sleep(5)
        continue

    if task["id"] != task_id:
        raise RuntimeError("Unexpected task identity")
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
    if task["status"] == "completed":
        Path("result.json").write_text(json.dumps(task, indent=2))
        for index, image in enumerate(task["output"]["data"], start=1):
            print(index, image["size"], image["url"])
        break
    time.sleep(5)
else:
    print("Still waiting. Keep submitted.json and resume this GET later.")

10분 제한은 이 예제 클라이언트의 제한입니다. 작업을 취소하거나 생성 실패를 입증하지 않습니다. 이 통합의 지연 시간 범위는 측정으로 확립하지 않았으므로, 고정된 초 단위를 약속하기보다 대기 상태를 구현합니다. 준비된 파일은 다운로드하여 저장하고, 결과 URL을 영구 에셋 저장소로 취급하지 않습니다.

Seedream 5.5로 생성한 리넨 식탁보 위 도자기 여우 찻주전자

이 샘플은 1248 × 832픽셀입니다. 1K 프리셋은 해상도 등급이며 가로와 세로가 모두 1024라는 보장이 아닙니다. 레이아웃이나 비용 계산에 정확한 치수가 필요하면 결과의 size를 읽습니다.

유지할 요소를 명시하며 장면 변경하기

편집에는 공개 HTTP(S) URL을 담은 image를 추가합니다. 직접 호스팅한 원본 사진이나, 생성 후 다운로드하여 직접 호스팅한 파일일 수 있습니다. 참조는 파일 업로드, Base64 또는 data URI일 수 없습니다. 요청 처리 중 계속 접근 가능해야 합니다. 지원 입력 형식과 미디어 제한은 API 문서에 있습니다. 1

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/fox-teapot.png",
  "prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
  "size": "1K"
}

위 URL은 자리표시자이므로 접근 가능한 이미지로 바꿉니다. 의도적으로 별도 편집 작업을 제출하고 응답을 새 파일명으로 저장합니다. 모델은 이전 작업을 기억하지 않으므로 편집할 이미지를 보내야 합니다.

다중 참조의 경우 image는 최대 10개 URL 배열을 지원합니다. 첫 이미지의 제품, 두 번째 이미지의 배경처럼 각 이미지의 역할을 프롬프트에 지정합니다. 필요한 최소한의 참조로 시작합니다. 결과에서 중요한 세부 사항이 바뀌면 참조가 적을수록 어떤 지시나 원본이 변화를 일으켰는지 파악하기 쉽습니다.

유지는 지시이지 픽셀 고정이 아닙니다. 매번 편집 후 제품 실루엣, 라벨, 카메라 각도를 원본과 비교합니다. 포스터에는 정확한 제목을 따옴표로 묶고 실제 표시 크기에서 문장 부호, 이름, 날짜를 확인합니다. 작거나 장식적인 글자는 여전히 수동 수정이 필요할 수 있습니다. 이 가이드는 어떤 언어에서도 측정된 정확도를 약속하지 않습니다.

누끼 이미지에는 "background": "transparent"를 추가하고 "output_format": "png"를 유지합니다. JPEG는 해당 알파 채널을 담을 수 없습니다. 투명도 옵션은 생성과 편집에서 사용할 수 있으며, 레이어 모드에는 아래 별도 규칙이 적용됩니다.

포스터를 재사용 가능한 레이어로 분리하기

레이어 분리는 정확히 이미지 하나를 받습니다. 프롬프트는 선택 사항으로, 생략하여 모델이 요소를 선택하게 하거나 분리할 부분을 명시합니다. 디자인을 평가할 때는 작은 출력 제한으로 시작합니다.

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  },
  "output_format": "png"
}

max_images에는 기본 이미지도 포함됩니다. 따라서 4는 기본 이미지와 최대 세 레이어를 허용합니다. 허용 제한은 2–100, 기본값은 30이며 실제 반환 수는 더 적을 수 있습니다. 이 모드에서는 auto라도 background를 보내지 않습니다. 분리된 레이어는 이미 투명 PNG이며, output_format은 기본 이미지를 제어합니다. 1

Seedream 5.5 포스터 원본과 분리된 배경, 음악가 및 투명 텍스트 레이어

이 기존 미리보기는 원본 포스터와 반환된 투명 요소를 함께 보여 줍니다. 분리의 의미를 이해하는 데 유용하지만, 모든 포스터가 같은 수의 레이어로 나뉘거나 경계가 깔끔하다는 보장은 아닙니다.

각 결과와 함께 선택적 메타데이터를 확인합니다.

필드사용 방법
z_index큰 값을 작은 값 위에 배치합니다.
bounding_box.absolute기본 이미지 픽셀 단위의 왼쪽, 위쪽, 오른쪽, 아래쪽 좌표로 레이어를 배치합니다.
bounding_box.normalized0–1000 척도의 대응 좌표입니다.
name, description모델이 분리한 요소를 식별합니다.
text_recognition인식된 텍스트, 줄 및 제공 가능한 스타일 정보를 읽습니다.

URL만이 아니라 결과 JSON 전체를 보관합니다. 레이어 이미지 크기는 기본 캔버스에서의 배치 크기와 다를 수 있습니다. 구도를 재구성할 때 경계 상자를 사용하고 결과를 눈으로 확인합니다. 추천 글꼴은 추정치이며, OCR 메타데이터가 원본 글꼴이나 완성된 PSD 파일을 보장하지 않습니다. 장식 글자, 겹치는 요소, 프롬프트에서 제외한 텍스트로 인해 결과가 불완전할 수 있습니다.

비용 비교 전에 치수 선택하기

생성은 1K, 1.5K, 2K와 함께 총 921,600–4,624,220픽셀, 화면 비율 1:16–16:1 내의 정확한 WIDTHxHEIGHT 치수를 지원합니다. 레이어 모드는 해당 프리셋 또는 auto를 지원하지만 정확한 치수는 지원하지 않습니다. 이 규약에는 3K·4K 프리셋, 배치 n, seed, 빠른 프롬프트 최적화 모드가 없습니다. 다른 Seedream 버전의 매개변수를 확인 없이 옮기지 않습니다. 1

Playground와 같은 가격 소스에서 가져온 현재 요율은 다음과 같습니다.

현재 요금을 불러올 수 없습니다. 페이지를 새로고침하여 다시 시도하세요.

요율은 자동으로 갱신됩니다. API 키 하나로 모든 모델과 그룹을 사용합니다.

261만 픽셀 이하의 출력 요율을 L, 해당 경계 초과 요율을 H, 참조 이미지 요율을 R로 둡니다. 참조 없는 1K 생성은 L, 참조 하나를 쓰는 편집은 L + R입니다. 1K와 1.5K 모두 낮은 출력 요율을 사용합니다. 첫 번째를 포함한 모든 참조가 과금됩니다. 2

이미지 네 개를 요청하는 1K 레이어 작업의 예상 요금은 4L + R입니다. 기본 이미지와 레이어 두 개만 반환되고 각각 낮은 요율 구간에 있으면 최종 비용은 3L + R입니다. 출력 크기가 섞이면 이미지별로 계산합니다. 낮은 구간 이미지 두 개와 더 큰 이미지 한 개는 2L + H + R입니다. 기본 이미지도 출력 이미지이므로 계산에서 빠뜨리지 않습니다.

처음에는 선택한 제한에 해당하는 금액을 사전 확보합니다. 실제 출력을 정산한 뒤 사용하지 않은 금액을 해제하며, 실패한 작업은 환불됩니다. 정산 테스트에서 같은 완료 응답을 다시 재현해도 잔액이 두 번째로 변하지 않았습니다. 필요한 이미지 사용 사실이 모두 없는 완료 응답은 예상 수량을 관측된 출력으로 취급하는 대신 미정산 상태를 유지하는 것도 확인했습니다.

요청이나 결과에 주의가 필요할 때

검증 오류는 대개 모드 불일치를 나타냅니다. 레이어 모드의 다중 참조, 투명 JPEG, 지원하지 않는 크기, 생성 요청의 레이어 옵션 등이 해당합니다. 새 작업을 만들기 전에 요청을 수정합니다. 일시적 폴링 오류는 다릅니다. 기존 ID를 유지하고 GET을 재시도합니다. 둘은 별도의 판단이며, 일반적인 “모두 재시도” 처리로 합치면 유료 생성이 중복될 위험이 있습니다.

편집 결과가 좋지 않으면 한 번에 하나의 변경을 원본과 비교합니다. 더 큰 출력이라고 모델이 라벨을 유지하거나 제목을 올바르게 표현했다는 뜻은 아닙니다. 레이어는 실제 디자인에 가져오기 전에 가장자리와 누락된 메타데이터를 확인합니다. 콘텐츠 검토는 기본적으로 켜져 있으며, 콘텐츠 거부 후 검토를 끄고 자동 재제출해서는 안 됩니다.

Seedream 5.5는 이 규약에 따라 생성, 참조 편집 또는 분리 가능한 디자인 요소가 필요한 워크플로에 적합합니다. Seedream 5.0 Pro는 기본값과 제한이 다른 별도 모델입니다. 어느 한쪽이 항상 더 낫다고 주장할 수 있는 통제 비교는 수행하지 않았습니다. 이 가이드는 별도의 “5.5 Pro” 제공이나 무료 생성도 약속하지 않습니다. 현재 Playground와 가격은 모델 페이지에서 확인하거나, OpenAPI 문서를 사용하여 애플리케이션에 요청 검증을 구현합니다.

참고 자료

  1. Seedream 5.5 API 문서: 요청 필드, 기본값, URL 입력, 비동기 응답, 레이어 메타데이터입니다. 2026년 11월 12일 규약을 확인했습니다.
  1. Seedream 5.5 실시간 요금: 출력 픽셀 구간과 참조 이미지 요율입니다.
전체 게시물

작성자

avatar for Wan API
Wan API

카테고리

  • 제품
키와 작은 요청 하나로 시작하기새로고침 후에도 저장한 ID 폴링하기유지할 요소를 명시하며 장면 변경하기포스터를 재사용 가능한 레이어로 분리하기비용 비교 전에 치수 선택하기요청이나 결과에 주의가 필요할 때참고 자료

더 많은 게시물

Seedance 2.0 Fast vs Mini: 무엇을 테스트할까요?
제품

Seedance 2.0 Fast vs Mini: 무엇을 테스트할까요?

Seedance 2.0 Fast와 Mini의 제한, 참조 동영상 과금과 샘플을 비교하세요. 같은 제작 지시로 품질, 소요 시간과 쓸 만한 장면의 비용을 평가하세요.

avatar for Wan API
Wan API
2026. 10. 15.
Seedance 2.5 Flash 요금
제품

Seedance 2.5 Flash 요금

5초 장면의 Seedance 2.5 Flash 요금을 계산하세요. 실시간 480p 및 720p 요금을 기준으로 텍스트, 참조 영상, 편집을 비교합니다.

avatar for Wan API
Wan API
2026. 11. 18.
Seedance 2.5와 Seedance 2.0, 장면에 맞는 모델은?
제품

Seedance 2.5와 Seedance 2.0, 장면에 맞는 모델은?

Seedance 2.5와 Seedance 2.0의 길이, 참조 한도와 예시 설정을 비교합니다. 화질이나 속도를 단정하지 않고 공정한 동영상 테스트를 준비하세요.

avatar for Wan API
Wan API
2026. 10. 14.

Wan API 소식

서비스 업데이트와 모델 소식

구독하고 모델 소식, 서비스 업데이트 및 API 연동 정보를 받아보세요.

LogoWan API

Wan 3.0과 Wan 3.0 Prime. 다음 프로젝트를 위한 동영상 생성.독립 플랫폼입니다. Alibaba, Wan 또는 ByteDance와 제휴 관계가 없으며 이들의 보증을 받지 않습니다.

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
모델
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • 요금
개발자
  • 문서
  • Wan 3.0 가이드
  • 자주 묻는 질문
  • Wan API 소개
  • Wan API 문의
법적 고지
  • 개인정보 처리방침
  • 이용약관
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. 모든 권리 보유.