소개
이 엔드포인트가 하는 일
Seedream 5.0 Flash 이미지 편집은 레퍼런스 이미지 1~10장과 지시문을 받아 이미지 한 장을 돌려줍니다. 레퍼런스가 한 장이면 수정으로, 새 의상이나 새 계절, 새 장소로 바꿀 수 있습니다. 여러 장이면 얼굴, 의상, 장소를 한 프레임으로 합칩니다.
중요한 입력값
image_urls는 이미지 1~10장(jpeg, png, webp, 각 30MB 이하)을 받고, 그 순서가 곧 프롬프트에서 부르는 순서입니다. prompt는 최대 5,000자이며 소스마다 역할을 적어야 합니다. aspect_ratio는 열다섯 가지 형태 중에서 고르고, resolution은 1k, 1.5k, 2k(기본값 2k) 중에서 고르며, output_format은 jpeg와 png 중에서 고릅니다.
콘텐츠
필터 없는 의상 변경도 플래그나 별도 엔드포인트 없이 실행됩니다.
돌려받는 것
요청당 이미지 한 장이 플랫폼 애셋 URL로 전달됩니다. 과금은 제출 전에 보이는 견적에 따라 이미지 장당으로 이루어집니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 텍스트→이미지, 이미지 편집, 레이어 분해 |
| 텍스트·편집 입력 | 프롬프트 최대 5,000자, 편집은 레퍼런스 이미지 1~10장 |
| 화면비 | 1:3~3:1 사이 15종 |
| 해상도 | 1k, 1.5k, 2k(기본값 2k). 세 단계 모두 이미지당 가격이 같음 |
| 레이어 분해 | 이미지 한 장을 넣으면 베이스 이미지와 투명 PNG 레이어 최대 16장을 출력(합계 최대 17장) |
| 재현성 | 시드 필드 없음. 같은 요청도 매번 다른 결과가 나옵니다 |
핵심 기능 및 하이라이트
철자가 정확히 들어간 포스터
이 페이지의 레트로 영화 포스터에는 크림색 세리프 제목, 태그라인, 노란 티켓 스텁이 모두 쓴 그대로 그려져 있습니다. 문구가 정해져 있다면 따옴표로 감싸고 놓을 위치도 적으세요. 가볍고 저렴한 등급에서도 레이아웃 지시가 통하는지 확인하는 첫 번째 테스트로 좋습니다.
사진 세 장에서 얼굴, 드레스, 장소를 한 번에
편집 엔드포인트는 레퍼런스 1~10장을 순서대로 읽습니다. 이 예시에서는 첫 번째가 얼굴과 헤어, 두 번째가 등이 파인 붉은 새틴 가운, 세 번째가 파리의 발코니이고, 프롬프트에 그렇게 적었습니다. 결과는 그 발코니에서 어깨 너머로 돌아보는 한 여성입니다. 소스마다 역할을 적지 않으면 모델이 뭉뚱그려 섞어 버립니다.
완성된 포스터를 움직일 수 있는 조각으로 나누기
레이어 분해는 들어낸 요소 뒤의 거리까지 메운 깨끗한 베이스 이미지와, 이름과 바운딩 박스가 붙은 요소별 투명 PNG를 돌려줍니다. 이 포스터에서는 다이너, 멀리 있는 자동차, 네온 사인, 여성, 태그라인, 제목, 티켓 스텁이 각각 분리되었고, 모든 조각이 원래 있던 자리에 정확히 들어갑니다. 문구를 바꾸거나, 조각 하나를 빼거나, 그 여성을 다른 디자인에 다시 쓸 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 모든 레퍼런스에 역할을 지정하고 바뀌면 안 되는 것을 적으세요. 1자 이상 · 5000자 이하 |
image_urls | 예 | 레퍼런스 이미지 1~10장(jpeg, png, webp, 각 30MB 이하). 순서가 의미를 가지며 프롬프트가 첫 번째, 두 번째, 세 번째로 부릅니다. 1개 이상 · 10개 이하 |
aspect_ratio | 아니요 | 1:3부터 3:1까지 열다섯 가지 중에서 고릅니다(4:5, 21:9, 9:21 포함). 게재 위치가 프레임을 정할 때 지정하세요. |
resolution | 아니요 | 1k, 1.5k, 2k 중에서 고르며 기본값은 2k입니다. 세 단계 모두 이미지당 가격이 같아서 기본값이 가장 선명합니다. |
output_format | 아니요 | 기본은 jpeg이고 png도 됩니다. png는 무손실이라 리터치로 넘기기에 안전합니다. |
background | 아니요 |
|
요금
$0.029 / 장
활용 사례
글자가 정확히 들어가는 포스터와 광고
레트로 영화 포스터, 악센트 문자가 들어간 향수 스틸, 프로모션 타일 등. 문구는 정확히 따옴표로 감싸고 위치를 지정하며, 공개 전에 철자를 확인하세요.
장면이 바뀌어도 이어지는 캐릭터
한 프레임의 얼굴과 다른 프레임의 의상이나 장소를 하나의 편집에 넣으세요. 재촬영 없이 같은 사람을 새로운 배경에 세우는 빠른 방법입니다.
에디토리얼과 영업 후 스틸
실크, 풀어 헤친 옷깃, 영업 후의 느린 춤. 필터 없는 이미지도 다른 것과 같은 엔드포인트에서 돌아가며, 따로 켜야 할 스위치는 없습니다.
디자인 작업에 다시 쓰는 레이어
포스터나 광고를 베이스 이미지와 요소로 나눈 뒤 헤드라인을 바꾸고, 소품 색을 바꾸고, 패럴랙스를 만들고, 피사체를 새 템플릿에 옮겨 보세요.
프롬프트 가이드 및 실전 팁
가진 소재에 맞춰 엔드포인트를 고르세요
글로 쓴 아이디어라면 텍스트→이미지, 바꾸거나 합치고 싶은 사진이라면 이미지 편집, 부분별로 따로 필요한 완성 이미지라면 레이어 분해입니다. 이미지를 돌려주는 두 엔드포인트는 1K, 1.5K, 2K 중 무엇을 골라도 가격이 같습니다.
형용사가 아니라 장면을 쓰세요
프레임에 누가 또는 무엇이 있는지, 무엇을 입었는지, 빛이 어디서 오는지, 렌즈나 필름 질감을 적습니다. 이 페이지의 비 내리는 창가 인물 사진은 다음과 같은 브리프에서 나왔습니다. 서른 살 안팎의 여성이 짙은 에메랄드빛 벨벳 드레스를 입고 빗물이 흐르는 밤 창가에 기대 있다. 유리와 쇄골에 분홍과 청록빛 도시 네온이 비치고, 그녀는 반쯤 미소 지으며 카메라를 돌아본다. 35mm 필름 느낌.
작업을 폴링하고 브리프도 보관하세요
작업을 만들고, 종료 상태가 될 때까지 폴링한 뒤, 플랫폼 스토리지에서 이미지를 가져옵니다. 시드가 없어서 같은 컷을 그대로 다시 그릴 수는 없습니다. 보관할 결과물 옆에는 프롬프트도 함께 저장해 두세요.
소개
Seedream 5.0 Flash 이미지 편집은 제공한 이미지를 글로 쓴 지시에 따라 바꾸거나 합칩니다. 레퍼런스를 1~10장 읽으므로, 수정 도구로도, 서로 다른 사진에서 하나의 장면을 조립하는 용도로도 쓸 수 있습니다.
ByteDance가 개발했습니다(모델 ID dola-seedream-5-0-flash-260915). 모든 해상도 단계의 이미지당 가격이 같습니다.
출발 소재로 Seedream 5.0 Flash 모드 고르기
| 출발 소재 | 모드 |
|---|---|
| 새 이미지를 위해 글로 쓴 브리프 | Seedream 5.0 Flash 텍스트→이미지 |
| 수정하거나 합칠 이미지 1~10장 | Seedream 5.0 Flash 이미지 편집 |
| 부분별로 따로 필요한 완성 이미지 | Seedream 5.0 Flash 레이어 분해 |
주요 특징
사람은 그대로, 나머지만 바꾸기
의상 교체 테스트에서 얼굴, 헤어스타일, 포즈, 컵, 침대는 그대로 두고 의상은 바뀌었으며, 아침 햇살은 오후 햇빛으로 바뀌었습니다.
레퍼런스 10장, 각자 맡은 역할
위치로 역할을 지정합니다. 한 테스트에서는 사진 세 장을 썼습니다. 첫 번째는 얼굴과 헤어, 두 번째는 등이 파인 붉은 새틴 가운, 세 번째는 파리의 발코니였습니다. 결과는 그 발코니에서 그 가운을 입은 한 여성이었습니다.
피사체를 지키며 장면 바꾸기
옥상 인물 사진을 비 오는 네온 골목으로 옮겼습니다. 같은 남성, 같은 풀어 입은 셔츠와 포즈 그대로, 이제는 비에 젖었고 젖은 바닥과 피부에 분홍과 청록빛 간판이 비칩니다.
필터 없는 의상 작업
필터 없는 의상 변경과 리라이팅은 같은 엔드포인트에서 플래그 없이 실행됩니다.
활용 사례
재촬영 없이 사진의 스타일 바꾸기
의상, 날씨, 시간대, 장소를 바꾸고 유지해야 할 것을 적으세요.
얼굴, 의상, 장소 조합하기
재료마다 레퍼런스 한 장씩을 쓰고 어느 것이 무엇인지 적으세요.
캐릭터 세트 만들기
같은 얼굴을 여러 장면에서 쓰면서 의상과 배경을 바꿉니다.
완성된 프레임의 조명 다시 잡기
새로운 광원, 방향, 색을 요청하고 피사체는 고정해 두세요.
프롬프트 가이드와 팁
모든 레퍼런스에 이름을 붙이세요
image_urls에는 프롬프트에서 쓰는 순서대로 이미지를 넣으세요. 각각이 무엇을 담당하고 무엇을 건드리지 말아야 하는지 적습니다.
- 첫 번째 이미지: 유지할 사람.
- 다른 레퍼런스는 구체적인 역할이 있을 때만 추가합니다.
- 바뀌면 안 되는 것을 씁니다.
- 새 배경과 빛을 묘사합니다.
이미지 1은 유지할 얼굴과 헤어스타일이다. 이미지 2는 등이 파인 붉은 새틴 가운만 제공한다. 이미지 3은 장소다.
이미지 1의 같은 여성이 이미지 3의 철제 난간 옆에 혼자 서서 이미지 2의 가운을 입고, 맨어깨 너머로 카메라를 돌아본다. 뒤에서 따뜻한 창가 불빛이 비친다.
원본에서 편집하세요
편집을 길게 이어 가면 결과가 점점 어긋납니다. 원본 프레임으로 돌아가 한 번에 한 가지씩 바꾸세요.
콘텐츠 경계
Seedream 5.0 Flash · 이미지 편집. SpicyAPI는 플랫폼 차원의 콘텐츠 필터를 추가하지 않습니다. 모델 자체의 제한은 그대로 적용되며 결과는 보장되지 않습니다. 콘텐츠 정책을 준수할 책임은 이용자에게 있습니다.
필터 없는 콘텐츠에는 별도의 스위치나 엔드포인트가 필요 없습니다. 미성년자가 포함된 자료, 동의 없는 성적 이미지, 실제 인물을 사칭해 오인시키는 자료는 제출하지 마세요. 이는 이용 제한 사항이며 모든 요청을 자동 심사한다는 의미는 아닙니다.
상업적 이용의 적합성, 필요한 권리 확보, 최종 편집 검토는 이용자의 책임입니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-flash/edit",
"input": {
"aspect_ratio": "auto",
"background": "opaque",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
