소개
이 엔드포인트가 하는 일
Seedream 5.0 Flash 텍스트→이미지는 글로 쓴 브리프를 이미지 한 장으로 만들어 줍니다. 정확한 글자가 들어가는 포스터, 인물 사진, 제품 스틸, 필터 없는 에디토리얼 장면을 다루며, 어느 해상도 단계든 요금은 같습니다.
중요한 입력값
prompt는 최대 5,000자로, 피사체와 의상, 조명, 렌즈를 한 번에 담기에 충분합니다. aspect_ratio는 1:3에서 3:1 사이 열다섯 가지 중에서 고르며 기본값은 1:1입니다. 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자 이하 |
aspect_ratio | 아니요 | 기본값은 1:1이며, 1:3부터 3:1까지 다른 열네 가지 중에서 고를 수 있습니다(4:5, 21:9, 9:21 포함). 텍스트 엔드포인트에는 자동 모드가 없으므로 납품할 화면비를 직접 지정하세요. |
resolution | 아니요 | 1k, 1.5k, 2k 중에서 고르며 기본값은 2k입니다. 세 단계 모두 이미지당 가격이 같아서 기본값이 가장 선명합니다. |
output_format | 아니요 | 기본은 jpeg이고 png도 됩니다. png는 무손실이라 리터치나 합성으로 넘기기에 안전합니다. |
요금
$0.029 / 장
활용 사례
글자가 정확히 들어가는 포스터와 광고
레트로 영화 포스터, 악센트 문자가 들어간 향수 스틸, 프로모션 타일 등. 문구는 정확히 따옴표로 감싸고 위치를 지정하며, 공개 전에 철자를 확인하세요.
장면이 바뀌어도 이어지는 캐릭터
한 프레임의 얼굴과 다른 프레임의 의상이나 장소를 하나의 편집에 넣으세요. 재촬영 없이 같은 사람을 새로운 배경에 세우는 빠른 방법입니다.
에디토리얼과 영업 후 스틸
실크, 풀어 헤친 옷깃, 영업 후의 느린 춤. 필터 없는 이미지도 다른 것과 같은 엔드포인트에서 돌아가며, 따로 켜야 할 스위치는 없습니다.
디자인 작업에 다시 쓰는 레이어
포스터나 광고를 베이스 이미지와 요소로 나눈 뒤 헤드라인을 바꾸고, 소품 색을 바꾸고, 패럴랙스를 만들고, 피사체를 새 템플릿에 옮겨 보세요.
프롬프트 가이드 및 실전 팁
가진 소재에 맞춰 엔드포인트를 고르세요
글로 쓴 아이디어라면 텍스트→이미지, 바꾸거나 합치고 싶은 사진이라면 이미지 편집, 부분별로 따로 필요한 완성 이미지라면 레이어 분해입니다. 이미지를 돌려주는 두 엔드포인트는 1K, 1.5K, 2K 중 무엇을 골라도 가격이 같습니다.
형용사가 아니라 장면을 쓰세요
프레임에 누가 또는 무엇이 있는지, 무엇을 입었는지, 빛이 어디서 오는지, 렌즈나 필름 질감을 적습니다. 이 페이지의 비 내리는 창가 인물 사진은 다음과 같은 브리프에서 나왔습니다. 서른 살 안팎의 여성이 짙은 에메랄드빛 벨벳 드레스를 입고 빗물이 흐르는 밤 창가에 기대 있다. 유리와 쇄골에 분홍과 청록빛 도시 네온이 비치고, 그녀는 반쯤 미소 지으며 카메라를 돌아본다. 35mm 필름 느낌.
작업을 폴링하고 브리프도 보관하세요
작업을 만들고, 종료 상태가 될 때까지 폴링한 뒤, 플랫폼 스토리지에서 이미지를 가져옵니다. 시드가 없어서 같은 컷을 그대로 다시 그릴 수는 없습니다. 보관할 결과물 옆에는 프롬프트도 함께 저장해 두세요.
소개
Seedream 5.0 Flash 텍스트→이미지는 글로 쓴 브리프에서 새 이미지를 만듭니다. 진짜 글자가 들어가는 포스터, 인물 사진, 제품과 향수 스틸, 에디토리얼이나 영업 종료 후 분위기의 장면처럼, 사진이 아니라 말에서 출발하고 싶을 때 사용하세요.
ByteDance가 개발했습니다(모델 ID dola-seedream-5-0-flash-260915). 모든 해상도 단계의 이미지당 가격이 같으므로 기본값이 가장 선명한 2K입니다.
출발 소재로 Seedream 5.0 Flash 모드 고르기
| 출발 소재 | 모드 |
|---|---|
| 새 이미지를 위해 글로 쓴 브리프 | Seedream 5.0 Flash 텍스트→이미지 |
| 수정하거나 합칠 이미지 1~10장 | Seedream 5.0 Flash 이미지 편집 |
| 부분별로 따로 필요한 완성 이미지 | Seedream 5.0 Flash 레이어 분해 |
주요 특징
쓴 그대로 나오는 글자
이 페이지의 레트로 영화 포스터에는 크림색 세리프 제목, 태그라인, 티켓 스텁이 브리프대로의 철자로 들어 있습니다. 향수 광고에서도 악센트가 붙은 헤드라인이 정확히 그려졌습니다. 문구는 정확히 따옴표로 감싸고 놓을 위치를 적으세요.
화면비 15종과 균일 가격 3단계
aspect_ratio는 1:3부터 3:1까지, resolution은 1k, 1.5k, 2k(기본값 2k)입니다. 저희 테스트에서 21:9의 2K는 3136×1344, 4:5의 1.5K는 1376×1712로 나왔습니다.
스위치 없이 쓰는 필터 없는 이미지
필터 없는 프롬프트도 다른 것과 같은 엔드포인트에서 실행되며, 연령 등급 플래그는 없습니다.
5,000자 브리프
피사체, 의상, 조명, 렌즈, 색보정까지 프롬프트 하나에 담기에 충분합니다.
활용 사례
영화 포스터와 광고 스틸
제목과 태그라인을 따옴표로 감싸고, 그 주변의 구도를 설명하세요.
캐릭터 인물 사진 시리즈
먼저 강한 연출 하나를 쓴 뒤, 이미지 편집 엔드포인트로 그 얼굴을 새로운 장면으로 이어 가세요.
와이드 배너
이 페이지의 수영장 옆 수영 선수처럼 영화 같은 넓은 프레임에는 21:9를 지정하세요.
영업 후 에디토리얼
아침의 부드러운 창가 빛, 파리 발코니의 실크, 무도회장에 단둘이 있는 두 댄서.
프롬프트 가이드와 팁
장면을 쓰세요
프레임에 누가 또는 무엇이 있는지, 무엇을 입었는지, 빛이 어디서 오는지, 렌즈나 필름 질감을 적습니다. 이 페이지의 비 내리는 창가 인물 사진은 35mm 필름 느낌과 분홍·청록 도시 네온을 사용했습니다.
aspect_ratio로 형태를 고릅니다.- 피사체, 의상, 배경을 묘사합니다.
- 빛의 방향, 색, 강도를 씁니다.
- 글자는 정확히 따옴표로 감싸고 놓을 위치를 적습니다.
레트로 영화 포스터, 세로 3:4. 붉은 트렌치코트를 입은 여성이 붉은 네온 사인 아래 비 내리는 밤의 다이너 노점 앞에서 종이컵 커피를 들고 있다.
윗부분 가득 크림색 세리프 제목 "LATE SHIFT". 그 아래에 더 작은 한 줄 "Some orders never get cancelled".
오른쪽 아래에는 "ADMIT ONE"이라고 적힌 노란 티켓 스텁.
지정한 글자만 사용하고, 불필요한 배지나 로고는 넣지 않는다.
초안은 1k로, 납품은 2k로
모든 단계의 가격이 같으므로 낮은 해상도로 초안을 뽑아도 절약되지는 않지만, 구도를 다듬는 동안에는 1k가 검토하기 더 빠릅니다.
콘텐츠 경계
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/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k",
"aspect_ratio": "1:1",
"output_format": "jpeg"
}
}'
# 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 레퍼런스에서 확인하세요.
