
숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.
* 실제 비용은 최종 출력에 따라 달라집니다.
새 장면이나 부분 편집을 위한 Seedream5.5 API 초안을 준비하세요. 피사체, 조명과 구도를 정한 뒤 변경할 내용과 유지할 세부 사항을 구분해 작성하세요.
Seedream5.5 API 예제는 프롬프트, 참조 이미지, 크기, 해상도, 출력 옵션을 포함하는 APIMart 공통 비동기 작업 형식을 사용합니다. 반환된 작업 ID로 결과를 별도로 조회하세요.
APIMart API 키를 APIMART_API_KEY에 저장하세요. Seedream5.5 API 예제는 제출과 작업 조회 모두에 Authorization: Bearer <key>를 사용합니다.
POST /v1/images/generations에 model: seedream-5-5를 전송합니다. 편집에는 image_urls를 추가하고 응답에서 task_id를 읽습니다. Python 예제는 data로 감싼 응답도 처리합니다.
GET /v1/tasks/{task_id}로 조회합니다. SUCCESS이면 result.images, FAILURE이면 fail_reason을 확인합니다. 예제는 completed/failed 상태도 처리합니다.
APIMart 인증과 일반적인 API 사용법은 APIMart 문서를 참고하세요.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-5",
"prompt": "밝은 나무 테이블 위에 흰색 도자기 컵을 놓은 잡지 스타일 제품 포스터. 부드러운 측면 조명, 상단에 \"아침의 루틴\"이라는 제목, 읽기 쉬운 글자와 넉넉한 여백.",
"size": "16:9",
"resolution": "1.5K",
"output_format": "png"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "seedream-5-5",
"prompt": "밝은 나무 테이블 위에 흰색 도자기 컵을 놓은 잡지 스타일 제품 포스터. 부드러운 측면 조명, 상단에 \"아침의 루틴\"이라는 제목, 읽기 쉬운 글자와 넉넉한 여백.",
"size": "16:9",
"resolution": "1.5K",
"output_format": "png"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
submitted = resp.json()
submitted = submitted.get("data", submitted)
submitted = submitted[0] if isinstance(submitted, list) else submitted
task_id = submitted["task_id"]
# 2. Poll the task until it finishes
for _ in range(180):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()
task = task.get("data", task)
status = task["status"].lower()
if status in ("success", "succeeded", "completed"):
print(task["result"]["images"][0]["url"][0])
break
if status in ("failure", "failed", "error"):
raise RuntimeError(task.get("fail_reason") or task.get("error", {}).get("message", "generation failed"))
time.sleep(5)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-5",
"prompt": "참조 이미지의 제목 \"아침의 루틴\"을 \"저녁의 평온\"으로 바꾸세요. 컵, 테이블, 조명, 글자 위치와 나머지 모든 요소는 유지하세요.",
"image_urls": [
"https://example.com/reference.png"
],
"size": "2K",
"output_format": "png"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| 매개변수 | 유형 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: seedream-5-5 | 이 Seedream5.5 API 작업 공간과 예제의 모델 설정값: seedream-5-5. |
prompt | string | 필수 | 기본값: — | Seedream5.5 지시문입니다. 새 이미지 또는 편집 내용과 유지할 세부 사항을 설명하세요. layer_decomposition이 true이면 생략할 수 있습니다. |
size | string | 선택 | 기본값: 2K | 기본값 2K. 1K/1.5K/2K, 비율과 resolution 또는 픽셀 크기(921,600–4,624,220픽셀, 비율 1/16–16)를 지원합니다. 레이어: auto/1K/1.5K/2K만 지원. 기본 이미지와 각 레이어는 선택한 해상도 등급으로 출력되며 각 비율을 유지합니다. auto는 입력 크기를 1K~2K 범위로 맞추고 높은 등급으로 선차감합니다. 기본값은 2K입니다. 1K 또는 1.5K를 선택하면 더 저렴합니다. 참조 이미지는 별도 과금됩니다. 이미지 생성에서 auto는 2K와 같습니다. |
resolution | string | 선택 | 기본값: 2K / auto | 비율 지정 생성에서는 1K / 1.5K / 2K(기본 2K)를 사용합니다. 레이어 분해는 size가 우선이며 생략한 경우에만 resolution을 사용합니다. 1K / 1.5K / 2K / auto만 지원하며 기본값은 auto입니다. |
image_urls | array | 선택 | 기본값: — | 투명 생성도 참조 이미지 최대 10장을 지원합니다. HTTP(S) URL, 이미지 Data URI 또는 로컬 JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF 파일을 사용할 수 있습니다. 장당 최대 30 MiB, 3,600만 픽셀. 로컬 파일은 실행 시 업로드됩니다. 레이어 분해에는 참조 이미지가 정확히 1장 필요합니다. 출력 등급 가격 + 참조 수 × 입력 이미지 가격. 모든 참조 이미지에 요금이 부과됩니다. |
output_format | string | 선택 | 기본값: png | 출력 형식은 jpeg 또는 png입니다. 양식에서 투명 배경을 선택하면 PNG가 자동 선택됩니다. 레이어 분리에서는 기본 이미지 형식에만 적용되며, 나머지 레이어는 항상 PNG입니다. |
background | string | 선택 | 기본값: auto | auto(기본값), transparent 또는 opaque. 참조 이미지 없이도 투명 생성이 가능하며 PNG가 필요합니다. 레이어 모드에서는 background를 생략합니다. |
layer_decomposition | boolean | 선택 | 기본값: false | 참조 이미지 1장, 프롬프트는 선택 사항입니다. size: auto/1K/1.5K/2K. background는 전송하지 않습니다. max_images × 등급 가격에 참조 이미지 1장 요금을 더해 선차감합니다. 2~100장(기본 30)을 선택하며 실제 출력 수와 픽셀 등급으로 정산합니다. 상한을 낮추면 선차감액이 줄어듭니다. |
optimize_prompt_options | object | 선택 | 기본값: standard | {"mode":"standard"}. 프롬프트 최적화는 항상 standard이며 끌 수 없습니다. 매개변수를 생략해도 standard가 적용됩니다. |
watermark | boolean | 선택 | 기본값: false | 출력 이미지에 AI 생성 워터마크를 추가할지 지정합니다. |
nsfw_check | boolean | 선택 | 기본값: false | API 작업을 처리하기 전에 프롬프트와 입력 이미지를 검토할지 지정합니다. |
n | integer | 선택 | 기본값: 1 | 일반 생성은 이미지 1장을 출력합니다. JSON은 n: 1만 허용하며 작업 공간은 정규화된 설정에서 이 필드를 생략합니다. |
layer_decomposition_options.max_images | integer | 선택 | 기본값: 30 | max_images × 등급 가격에 참조 이미지 1장 요금을 더해 선차감합니다. 2~100장(기본 30)을 선택하며 실제 출력 수와 픽셀 등급으로 정산합니다. 상한을 낮추면 선차감액이 줄어듭니다. 30장을 초과하면 시간이 더 걸리며, 100장은 약 5분이 걸릴 수 있습니다. |
layer_decomposition_options.text_recognition | boolean | 선택 | 기본값: false | 지원되는 텍스트 레이어의 문자와 추정 스타일을 반환합니다. 손글씨, 장식 글자, 비텍스트 레이어에는 OCR이 없을 수 있습니다. OCR이 필요하면 프롬프트를 비워 두세요. 프롬프트를 입력하면 인식 결과가 반환되지 않을 수 있습니다. |
Seedream5.5의 기능을 바탕으로 API 프롬프트, 참고 이미지와 편집 지침을 구성하세요.
각 Seedream5.5 API 제작 지침을 구체적인 디자인 작업과 검토 항목에 연결하세요.
설정을 복사하기 전에 프롬프트, 참고 이미지와 API 필드를 함께 검토하세요.
prompt에 장면이나 구체적인 수정 내용을 설명하세요. 이미지에 들어갈 정확한 문구를 따옴표로 표시하고 각 수정 위치와 유지할 세부 사항을 명시하세요.
투명 생성도 참조 이미지 최대 10장을 지원합니다. HTTP(S) URL, 이미지 Data URI 또는 로컬 JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF 파일을 사용할 수 있습니다. 장당 최대 30 MiB, 3,600만 픽셀. 로컬 파일은 실행 시 업로드됩니다.
폼과 JSON은 같은 검증을 사용합니다. 로컬 참조는 실행 시 업로드됩니다. 레이어는 참조 1장과 선택 프롬프트, 일반 생성은 필수 프롬프트를 사용합니다.
Seedream5.5 프롬프트, 편집 방법, API 키, 요청 필드와 JSON 설정.
Seedream5.5는 ByteDance의 이미지 생성·편집 모델입니다. 부분 수정, 연속 편집의 일관성, 인물과 재질 표현, 다중 이미지 합성, 다국어 텍스트, 투명 소재와 레이어 분리를 다룹니다.
Seedream5.5 API 프롬프트는 피사체와 장면으로 시작하고 구도, 재질과 빛을 추가하세요. 편집 시 변경 사항과 유지할 내용을 지정하고, “더 좋게” 같은 모호한 지시 대신 구체적인 위치를 설명하세요.
API 프롬프트에서 물체와 위치를 지정하세요. 예를 들어 왼쪽의 파란 컵을 흰색 도자기 컵으로 바꾸면서 테이블과 화면 구도를 유지하도록 요청할 수 있습니다. 편집 영역과 함께 주변 세부 사항도 확인하세요.
이미지가 자동으로 기억된다고 가정하지 마세요. Seedream5.5의 각 수정에 편집할 이미지를 제공하고, 필요하면 이전 결과나 참고 이미지를 다시 포함하세요. API 예제에서는 image_urls에 입력 이미지를 나열하고 역할을 설명하세요.
Seedream5.5 API 프롬프트에서 이미지 A는 피사체, B는 배경, C는 색감처럼 참고 이미지의 역할을 지정하세요. 상대적 크기, 시점, 배치와 빛의 방향을 설명해 입력 요소가 조화를 이루도록 하세요.
Seedream5.5에 원하는 표정이나 자세를 설명하고 유지할 얼굴 특징, 의상, 비율과 화면 구도를 나열하세요. 표정만 바꾸려면 범위를 명확히 제한하고, 편집 후 인물의 다른 부분도 확인하세요.
API 프롬프트에서 전체 문구를 따옴표로 표시하세요. 제목, 라벨과 본문을 위치가 명확한 블록으로 나눈 뒤, 실제 표시 크기에서 Seedream5.5의 텍스트를 확인하세요. 특히 숫자, 문장 부호와 반복 라벨을 살펴보세요.
Seedream5.5에 언어별 정확한 문구를 제공하고 관련 텍스트 블록을 지정하세요. API 프롬프트에 위치와 읽는 순서를 명시한 뒤 모든 언어의 철자와 레이아웃을 검토하세요.
Seedream5.5 API 프롬프트에서 “여름 할인”을 “가을 할인”으로 바꾸는 등 대체 문구를 명시하세요. 텍스트 위치를 지정하고 주변 그래픽, 정렬과 다른 문구를 유지한 뒤 기존 글자가 완전히 제거되었는지 확인하세요.
auto(기본값), transparent 또는 opaque. 참조 이미지 없이도 투명 생성이 가능하며 PNG가 필요합니다. 레이어 모드에서는 background를 생략합니다.
투명, 반투명 가공, 광택, 무광, 금속 등 표면 특성을 지정하세요. 빛의 방향, 반사와 반투명 물체를 통해 보여야 할 내용을 설명하고 참고 이미지에서 유지할 재질 특징도 명시하세요.
참조 이미지 1장, 프롬프트는 선택 사항입니다. size: auto/1K/1.5K/2K. background는 전송하지 않습니다. max_images × 등급 가격에 참조 이미지 1장 요금을 더해 선차감합니다. 2~100장(기본 30)을 선택하며 실제 출력 수와 픽셀 등급으로 정산합니다. 상한을 낮추면 선차감액이 줄어듭니다. 지원되는 텍스트 레이어의 문자와 추정 스타일을 반환합니다. 손글씨, 장식 글자, 비텍스트 레이어에는 OCR이 없을 수 있습니다.
API 키 받기를 눌러 APIMart 키 관리 페이지를 여세요. 키를 서버 환경 변수 APIMART_API_KEY에 저장하고 예제의 Authorization 헤더에 사용하세요. API 키를 프롬프트, 참고 이미지 URL이나 공개 코드에 넣지 마세요.
Seedream5.5 API 예제는 model, prompt, image_urls, size, resolution, output_format을 사용합니다. 추가 옵션에는 background, layer_decomposition, optimize_prompt_options, watermark, nsfw_check가 있습니다. 일반 생성은 이미지 1장을 출력하고 n은 1만 허용합니다. 기본값과 필드 간 의존 관계는 매개변수 표에서 확인할 수 있습니다.
이 페이지에서 ByteDance Seedream5.5를 가리키는 이름 표기이며 Seedream 5.5로도 씁니다. seedream-5-5-api 같은 검색어는 요청 별칭이 아닙니다. 이 작업 공간과 API 예제의 model 설정값은 seedream-5-5입니다.
폼과 JSON은 같은 검증을 사용합니다. 로컬 참조는 실행 시 업로드됩니다. 레이어는 참조 1장과 선택 프롬프트, 일반 생성은 필수 프롬프트를 사용합니다.
같은 카테고리의 다른 모델을 탐색하세요.

GPT Image 2.6 Sunburst
GPT Image 2.6 Sunburst brings a fresh burst of creativity to your ideas. From vibrant illustrations to atmospheric scenes and striking product concepts, explore rich colors, expressive lighting, and thoughtful compositions that make your vision shine.

GPT Image 2.6 Flare
GPT Image 2.6 Flare brings your imagination into focus, turning creative ideas into expressive visuals. From cinematic scenes and bold illustrations to polished product concepts, explore color, light, and composition to give every idea its own distinctive look.

Muse Image Ext
Muse Image turns inspiration into compelling visuals. From a spark of an idea to a fully imagined scene, it helps bring your creative vision to life with images that express your style and tell your story. Explore new possibilities and give every idea a visual voice.

Hy Image V3.5 Preview
HY Image 3.5 Preview is an image generation and editing model developed by Tencent Hunyuan. It supports text-to-image creation, reference-based generation, and multi-turn editing, allowing users to refine images through conversational instructions. With support for up to 4K output and flexible image dimensions, it offers a versatile tool for creating and refining visual content.