소개
Seedream 5.5 텍스트→이미지는 글로 묘사한 장면을 이미지로 만들며 제공한 문구가 들어간 디자인도 생성합니다. 기존 이미지가 아닌 설명에서 시작할 때 이 Seedream 5.5 API 엔드포인트를 사용하세요. 잡지 표지와 라멘 메뉴부터 인물 사진, 투명 제품 그래픽까지 다양한 예시가 있습니다.
ByteDance는 사진 같은 출력, 정확한 작은 다국어 글자와 기본 RGBA PNG 투명도를 설명합니다. 저희 테스트는 이 기능의 구체적인 사례를 보여 줍니다. 2k 메뉴는 요청한 문구를 글자 단위로 재현했고 별도의 2k PNG에는 실제 알파 채널이 있었습니다. 레이아웃을 계획할 때 이 실측 사례를 참고하세요.
핵심 기능 및 하이라이트
글자를 넣는 AI 이미지 생성기
KAZE RAMEN 예시는 문구를 영어 제목, 일본어 부제, 메뉴 네 줄과 영업시간 각주로 나눕니다. 저희 테스트에서는 제공한 문구가 2k에서 재현됐습니다. NOIR 표지는 큰 제호, 작은 보조 문구와 바코드로 다른 위계를 구성합니다. 모델이 배치할 문구를 알 수 있도록 각 블록을 정확히 적으세요.
글자를 제어하려면 추가로 들어갈 문구에도 제한을 둬야 합니다. 저희 한 테스트에서는 이 제한이 없을 때 줄이 추가됐습니다. 제공한 문구만 필요한 디자인이라면 각 줄을 따옴표로 묶고 “다른 문구는 어디에도 넣지 마세요”라고 직접 지시하세요.
투명 PNG 생성 설정
여우 머그 예시는 흰 로고가 있는 유광 청록색 도자기 제품과 스튜디오 조명을 묘사합니다. 출력 설정은 PNG와 투명 배경입니다. 저희 2k 실측에서 파일에 투명도를 담는 알파 채널을 확인했습니다. 그래픽을 다른 합성 작업에 배치하려면 두 설정을 함께 선택하세요.
캔버스와 출력 선택
생성은 화면비 여덟 가지와 해상도 네 등급을 지원합니다. 기본 캔버스는 정사각형이고 기본 해상도는 2k입니다. 장면 설명만으로 형태가 정해지기를 기대하지 말고 사용처에 맞춰 선택하세요.
| 설정 | 선택 항목 | 기본값 |
|---|---|---|
aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 | 1:1 |
| resolution | 1k, 1.5k, 2k, 4k | 2k |
output_format | png, jpeg | png |
| background | auto, transparent, opaque | auto |
4k 등급에서 16:9는 3840 x 2160픽셀, 1:1은 2880 x 2880픽셀입니다. 이 크기는 해당 설정에 적용됩니다. JPEG는 불투명하므로 투명도가 필요한 작업에는 PNG를 유지하세요.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 현재는 검수가 적용되며, 검수 없는 버전도 곧 제공됩니다. 일부 요청은 거절되며 이 경우 과금하지 않습니다. 1자 이상 · 5000자 이하 |
aspect_ratio | 아니요 | 출력 캔버스를 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 중에서 정합니다. 기본값은 1:1이며 화면비 선택은 요금에 영향을 주지 않습니다. |
resolution | 아니요 | 과금에 적용할 해상도 등급을 1k, 1.5k, 2k, 4k 중에서 정합니다. 기본값은 2k입니다. |
output_format | 아니요 | png 또는 jpeg 인코딩을 선택하며 기본값은 png입니다. 인코딩은 요금에 영향을 주지 않습니다. |
background | 아니요 | 배경을 auto, transparent, opaque 중에서 정하며 기본값은 auto입니다. 알파 채널을 사용하려면 png와 transparent를 함께 선택하세요. |
요금
생성 이미지는 해상도 등급에 따라 과금합니다. 1k와 1.5k의 요율은 같으며 화면비, 인코딩, 배경 선택에 따른 추가 요금은 없습니다.
| 사양 | 요금 |
|---|---|
| $0.0195 / 장 |
| $0.0195 / 장 |
| $0.027 / 장 |
| $0.0525 / 장 |
활용 사례
제공한 다국어 문구로 메뉴 만들기
확인한 메뉴 문구에서 시작하고 각 줄의 위치를 지정하세요. KAZE RAMEN 예시처럼 가게 이름, 부제, 항목과 작은 각주를 구분하세요. 이미지를 사용하기 전에 반환된 글자를 제공한 문구와 대조하세요. 메뉴 실측은 이 사례를 뒷받침하지만 모든 글자 배치에서 같은 결과를 보장하지는 않습니다.
위계가 분명한 잡지 표지
표지 장면을 묘사한 뒤 제호와 보조 문구를 구분하세요. NOIR 예시는 필요한 문구를 따옴표로 묶고 추가 문구를 금지합니다. 제목이 정확해야 할 때 이 지시 방식을 참고하세요. 모든 글자를 같은 수준으로 두지 말고 각 블록의 상대적 크기와 위치를 설명하세요.
구체적인 연출을 담은 사진 장면
바닷가 인물 사진은 리넨 셔츠, 해 질 무렵의 빛과 필름 그레인으로 분위기를 정합니다. 재즈 바 예시는 두 사람, 의상, 느린 춤과 호박색 실내 조명을 명시합니다. 누가 어디에 등장하고 무엇을 입으며 빛은 어떤 모습인지 구체적으로 적으세요.
다른 레이아웃에 쓸 제품 그래픽
투명 출력 설정을 선택하기 전에 머그의 소재, 색상, 로고와 보는 각도를 설명하세요. “배경에서 분리된 제품 컷아웃” 같은 문구는 구도를 전달합니다. PNG에 투명도를 담을지는 background 설정이 정합니다. 제품 묘사와 파일 설정을 일치시키세요.
프롬프트 가이드 및 실전 팁
꾸미는 표현보다 장면부터 적기
중심 피사체와 장소로 시작하세요. 이어서 결과에 필요한 소재, 색상, 조명과 사진 표현을 적으세요. 예를 들어 “흰 여우 로고가 있는 청록색 도자기 머그, 부드러운 스튜디오 조명”처럼 쓰세요. 관련 없는 물체나 임의의 문구를 더하지 않고 구체적인 시각 지시를 줄 수 있습니다.
유지할 문구를 모두 따옴표로 묶기
“제호: 'NOIR'” 또는 “제목: 'KAZE RAMEN'”처럼 짧은 역할명을 사용하세요. 각주는 제목과 구별되도록 따로 지시하세요. “사진 위에 'NOIR'를 큰 세리프 글자로 배치하세요”처럼 문구와 위치를 함께 적으세요. 번역을 지어내도록 맡기지 말고 원하는 언어의 문구를 직접 제공하세요.
추가 문구의 범위 제한하기
따옴표로 지정한 문구 뒤에 “제공한 문구만 사용하고 다른 글자는 넣지 마세요”라고 덧붙이세요. 이 조언은 제한이 없을 때 글자가 추가된 저희 테스트에 근거합니다. 생성 후 작은 보조 문구까지 모든 줄을 프롬프트와 대조하세요. 블록이 빠졌거나 역할이 다르면 지시를 수정하세요.
설정에서 프레임 정하기
레이아웃에 맞춰 세로 구도에는 3:4, 가로 장면에는 16:9를 선택하세요. “세로”라는 단어만으로 aspect_ratio를 대신하지 마세요. 설정을 그대로 두면 기본 1:1 캔버스가 적용됩니다. 해상도는 형태와 별도로 고르세요.
투명도를 명시적으로 설정하기
컷아웃에는 output_format png와 background transparent를 함께 사용하세요. “배경에서 분리된 제품 컷아웃” 같은 짧은 장면 설명은 시각적 목표를 전달하지만 JPEG에 알파 채널을 만들지는 못합니다. 불투명 결과가 필요하면 background opaque를, 배경 모드를 정하지 않았다면 auto를 사용하세요.
프롬프트 길이 안에서 지시하기
플랫폼은 최대 5,000자를 받으며 ByteDance는 영어 기준 600단어 이내를 권장합니다. 이 공간을 장면의 세부, 정확한 문구와 위치에 쓰세요. 프롬프트를 선택한 화면비, 해상도 등급과 다운로드한 이미지와 함께 저장하면 나중에 편집할 때 디자인 방향을 확인할 수 있습니다.
관련 모델은 Seedream 5.0 Pro와 Seedream 5.0 Flash를 참고하세요.
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.5/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"background": "auto",
"resolution": "2k",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# 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 레퍼런스에서 확인하세요.
