Seedream 4.0 편집은 참조 이미지를 1~10장 받아, 16가지 크기 프리셋 중 고른 크기로 이미지 한 장을 돌려줍니다. 크기와 참조 수에 관계없이 이미지당 $0.03입니다. 마스크, 강도 슬라이더, 시드가 없으므로 제어는 전적으로 프롬프트에 달려 있습니다. 의상, 배경, 조명 변경이나 스케치를 렌더로 바꾸는 작업에 쓰고, 나머지 픽셀이 하나도 바뀌면 안 되는 편집에는 쓰지 마세요.
SpicyAPI는 이 편집기에 플랫폼 차원의 추가 콘텐츠 필터를 두지 않습니다. 2026년 9월 테스트에서는 강도가 높은 성인 대상 편집이 작업은 성공으로 표시되는데도 요청보다 약하게 나오는 경우가 가끔 있었습니다. 사용하기 전에 이미지를 직접 확인하세요.
참조마다 역할 지정하기
이미지를 image_urls에 담아 보내고, 프롬프트에서는 순서대로 이미지 1, 이미지 2처럼 가리킵니다. 언급하지 않은 참조는 무시되지 않고 결과에 섞여 들어갑니다. 각 소스에 역할을 하나씩 주고, 무엇이 유지되어야 하는지 말하세요.
의상 편집이라면 단순한 재킷을 입은 가상의 성인 이미지(승인된 것) 한 장을 올리고 1728*2304를 선택한 뒤 다음처럼 씁니다.
이미지 1에서 가상의 성인의 얼굴, 헤어스타일, 포즈, 손, 카메라 시점, 배경을 유지하세요. 재킷만 기존 크림색 셔츠 위에 입은 불투명한 버건디 벨벳 블레이저로 바꾸세요. 원래 재킷의 길이와 어깨 형태를 유지하세요. 기존 조명 아래에서 부드러운 벨벳 광택이 보이게 하고, 라펠은 또렷하게, 새 장신구나 텍스트는 넣지 마세요.
"옷을 더 고급스럽게 만들어 줘"라고만 하면 옷의 구조가 열려 있어 전혀 다른 의상이 나올 수 있습니다. 특정 블레이저를 그대로 맞추려면 이미지 2로 추가하고 소재 문장을 이렇게 바꿉니다. "이미지 2는 버건디 블레이저의 재단, 라펠, 원단을 정의합니다. 그 의상만 사용하고, 인물, 포즈, 장면은 이미지 1에서 유지하세요." 의상 사진은 옷만 보이도록 잘라 주세요. 패션 사진 전체를 쓰면 그 사진의 얼굴, 몸, 조명까지 함께 들어옵니다.
SpicyAPI는 참조를 최대 10장까지 받습니다. 파일은 JPG, PNG, WEBP, GIF이며 각각 10MB 이하여야 하고, 사용 권리를 가진 이미지여야 합니다.
정확한 크기 고르기
Seedream 4.0은 size를 width*height 형식의 문자열(가로*세로)로 받으며, 5.0 모델의 resolution, aspect_ratio 필드를 쓰지 않습니다. 기본값은 2048*2048입니다. 결과는 원본에서 잘라 내는 것이 아니라 고른 프리셋 크기로 다시 구성됩니다. 따라서 세로형 원본을 기본 정사각형으로 보내면 구도가 새로 짜이면서 프레이밍이 달라질 수 있습니다. 원본의 비율에 맞추세요.
| 원하는 비율 | 표준 크기 | 큰 크기 |
|---|---|---|
| 정사각형 | 2048*2048 | 3072*3072 |
| 4:3 가로 | 2304*1728 | 3456*2592 |
| 3:4 세로 | 1728*2304 | 2592*3456 |
| 3:2 가로 | 2496*1664 | 3744*2496 |
| 2:3 세로 | 1664*2496 | 2496*3744 |
| 16:9 가로 | 2848*1600 | 4096*2304 |
| 9:16 세로 | 1600*2848 | 2304*4096 |
| 초광각 (21:9) | 3136*1344 | 없음 |
1024*1024가 남은 프리셋입니다. 그 밖의 크기는 거부됩니다. 4096*2304는 SpicyAPI의 Seedream 편집기 중 가장 큰 프레임이며, 5.0 Lite는 최대 3136*1344입니다.
4:5 프리셋은 없습니다. 4:5 소셜 카드가 필요하면 1728*2304를 쓰고 약간 잘릴 여백을 남기거나, aspect_ratio: 4:5를 지원하는 Seedream 5.0 Flash(이미지당 $0.029) 또는 5.0 Pro로 바꾸세요. Pro는 이미지당 $0.036부터 시작하며 2K와 추가 참조에서는 더 비쌉니다.
먼저 Playground에서 시도하기
코드를 쓰기 전에 Playground에서 편집을 실행해 보세요. 여기서 결과가 틀리면 API에서도 틀리고, 해결책은 더 나은 프롬프트나 참조입니다.
- Seedream 4.0 편집 페이지를 열고 Playground 탭의 Form 보기에 머무르세요. 실행하려면 충전된 계정으로 로그인해야 합니다.
- Images에 소스를 추가합니다. 파일을 끌어다 놓거나 Add URL로 링크를 붙여 넣으세요. 최대 10장이며, 추가한 순서가 "이미지 1", "이미지 2"입니다.
- Prompt에 변경 내용을 쓰되, 각 이미지가 무엇을 제공하고 무엇이 유지되어야 하는지 밝히세요.
- 원본의 비율에 맞춰 Output size를 고릅니다.
- 가격 추정을 확인한 뒤 실행하세요. JSON 보기에서는 요청 본문을 볼 수 있으며, 이를 코드에 복사해 쓸 수 있습니다.
그다음 코드에서 호출하기
Python SDK를 설치하고(pip install spicyapi), 서버 환경에 SPICY_API_KEY를 설정한 뒤 실행합니다.
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="bytedance/seedream-4.0/edit",
input_data={
"image_urls": [
"https://example.com/person.png",
"https://example.com/blazer.png",
],
"prompt": "Keep the person, pose and scene from image one. Image two defines the burgundy blazer cut, lapels and fabric; use its garment only.",
"size": "1728*2304",
},
idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
print(output_assets(final)[0]["url"]) # copy it to your own storage now예시 URL 두 개는 직접 가진 URL로 바꾸세요. 로그인 없이 접근할 수 있어야 하며, 로컬 파일이라면 업로드한 뒤 반환된 spicy:// URI를 전달하세요. 결과 링크는 약 20분 뒤에 만료됩니다(보관 방식 자세히 보기). 견적, 업로드, 대기, 재시도, 오류는 Python SDK 레퍼런스와 비동기 작업 가이드에 정리되어 있습니다.
또는 에이전트에게 맡기기
어시스턴트가 대신 편집을 실행하게 하려면 CLI, MCP 서버, Skill 중 하나를 주세요. CLI와 MCP 서버는 가격을 보여 주고, 유료 호출 전에 확인을 요청합니다.
- CLI. 같은
input객체를input.json에 넣고 다음을 실행합니다(npx @spicyapi/cli는 설치 없이 동작합니다. CLI 문서 참고).
``bash spicyapi tasks create --model bytedance/seedream-4.0/edit --input-file input.json --wait ``
- MCP 서버. 어시스턴트에 MCP 서버를 추가한 뒤 이렇게 요청하세요. "./portrait.png를 Seedream 4.0으로 편집해 줘: 재킷만 버건디 벨벳 블레이저로 바꾸고, 크기는 1728*2304." 어시스턴트는
spicyapi_upload_file을 호출하고, 이어서 가격 확인을 위해 멈추는spicyapi_task_create, 그다음spicyapi_task_wait를 호출합니다. - Skill.
npx skills add spicyapi-ai/spicy-skill은 Agent Skill을 설치하며, 코딩 어시스턴트가 필드를 추측하는 대신 최신 모델 스키마를 읽게 합니다.
스케치를 소재 콘셉트로 바꾸기
스케치를 첫 번째, 소재 스와치를 두 번째로 두고 각각이 무엇을 담당하는지 말하세요. 가상의 시계 예시입니다.
이미지 1의 시계 스케치를 사실적인 제품 콘셉트로 바꾸세요. 이어지는 아치형 케이스, 중앙의 둥근 크림색 다이얼, 짧은 다리 두 개를 유지하세요. 이미지 2는 월넛의 색과 결에만 사용하세요. 다리에는 무광 황동 마감을, 다이얼에는 단순한 검은 시곗바늘 두 개를 주세요. 밝은 돌 표면 위의 정면 시점, 부드러운 측면 조명, 브랜드 표기와 추가 사물 없음.
의상에도 같은 분담이 통용됩니다. 그림은 실루엣, 원단 이미지는 표면, 승인된 인물 이미지는 입는 가상 인물을 정합니다. 중단된 선이 없는 깨끗한 스케치를 쓰세요. 정면만 그린 스케치로는 측면 모습을 정할 수 없으므로, 윤곽이 중요하면 먼저 정면 결과를 요청하세요.
구체적인 실패 해결하기
새 의상이 얼굴을 바꿨습니다. 원본 인물 이미지로 돌아가 의상 참조에서 다른 사람을 제거하고 원래 시점을 유지하세요. 얼굴이 픽셀 단위로 정확해야 한다면, 전체를 다시 그리게 하는 대신 승인된 얼굴을 기존 방식으로 합성하세요.
소재가 다른 사물로 번졌습니다. 표면을 지정하세요. 벨벳은 블레이저에만 해당하고 셔츠는 크림색 면이며, 월넛은 시계 케이스에만 해당하고 다이얼이나 황동 다리에는 해당하지 않습니다. 방 전체를 "스타일" 이미지로 쓰는 것보다 좁은 스와치가 더 명확합니다.
스케치의 실루엣이 바뀌었습니다. 스케치를 단순화하고 정면 시점을 요청하세요. 극적인 각도는 유지하려던 윤곽을 가릴 수 있습니다.
피사체가 잘렸습니다. 비율에 맞는 프리셋을 고르고 머리, 발, 소품 주위에 여백을 요청하세요.
작은 로고나 문구가 틀렸습니다. 장면은 유지하고 그 요소만 기존 편집기에서 교체하세요. 마스크가 없으면 텍스트 수정은 국소 패치가 아니라 새로 다시 그리는 일입니다.
반복 편집하면 어긋납니다. 매번 프레임 전체를 다시 그립니다. 누적 변경이라면 마지막으로 채택한 결과를 사용하고 무엇이 달라졌는지 확인하세요. 원본으로 돌아간다면 채택한 변경을 모두 프롬프트에 포함하세요. 독립적인 변형은 공통 원본에서 시작하세요.
비용과 다른 모델을 고를 때
편집 3번은 $0.09, 10번은 $0.30입니다. 더 큰 프리셋이나 추가 참조에는 요금이 붙지 않습니다. 소스 없이 새 이미지를 만들려면 크기와 가격이 같은 Seedream 4.0 텍스트 투 이미지를 쓰세요.
4096*2304까지의 큰 프레임을 고정 요금으로 쓰려면 4.0을 고르세요. 4:5 같은 aspect_ratio, PNG 출력(모든 5.0 모델), 투명 배경(Flash와 Pro)이 필요하면 5.0 모델을 고르세요. 마스크, 유지되는 픽셀, 정확한 공학적 형상이 필요하면 다른 방법을 고르세요. 제품 사진으로 광고 크리에이티브를 만들려면 제품 사진에서 광고 크리에이티브로를 참고하세요.
