Seedream 5.0 Lite API 가이드: 텍스트 투 이미지와 이미지 편집

내용 요약

• Seedream 5.0 Lite는 바이트댄스의 이미지 모델입니다. HiAPI에서는 두 개의 엔드포인트를 제공합니다: seedream-5.0-lite/text-to-image와 seedream-5.0-lite/image-to-image. 두 엔드포인트 모두 이미지당 $0.035, 2K 또는 4K 동일 가격입니다.
• 이미지 안에서 텍스트를 정확하게 표현하는 데 뛰어나며, 단일 객체 변경, 간판 텍스트 교체, 최대 14장의 참조 이미지 합성 등 장면의 나머지 부분을 그대로 유지하면서 특정 부분만 편집하는 데도 능숙합니다.
• 모든 호출에는 aspect_ratio와 resolution을 반드시 제공해야 합니다. 텍스트 투 이미지 모델 페이지에서 바로 사용해 볼 수 있습니다. 신규 계정에는 무료 크레딧 200개가 제공됩니다.

텍스트 투 이미지 vs 이미지 투 이미지

	텍스트 투 이미지	이미지 투 이미지
모델 ID	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
필수 항목	prompt, aspect_ratio, resolution	위와 동일하며, 추가로 image_urls(1–14)
가격	이미지당 $0.035	참조 이미지 수와 관계없이 이미지당 $0.035
적합한 사용 사례	포스터, 메뉴판, 패키징, 인포그래픽	색상 변경, 텍스트 교체, 제품을 장면에 합성

HiAPI 실시간 가격, 2026년 10월 19일 기준 확인. 실패한 작업은 과금되지 않습니다.

4K와 2K의 가격이 동일하므로 인쇄용 크기가 필요하면 바로 4K를 요청하세요. $1로 약 28장의 이미지를 생성할 수 있습니다.

텍스트 투 이미지: 텍스트를 정확하게 표현

렌더링하려는 각 단어를 따옴표로 감싸고, 각 문자열의 위치를 지정하세요:

가상의 야시장 음식 축제를 주제로 한 수작업 실크스크린 인쇄 스타일 포스터, 상단에 큰 중국어 서예 제목 '夜市食堂', 바로 아래에 좁은 산세리프 서체로 영어 부제 'NIGHT MARKET CANTEEN', 하단에 날짜 라인 'OCT 17-19 · RIVERSIDE PIER', 붐비는 음식 노점을 감싸는 따뜻한 등불 빛, 대나무 찜기에서 피어오르는 김, 주색, 크림색, 먹빛 파랑의 한정된 팔레트, 눈에 보이는 인쇄 그레인, 빈티지 포스터 구도

이 포스터 생성하기 →

seedream-5.0-lite/text-to-image, 2K, $0.035.

중국어 제목, 영어 부제, 날짜 라인이 모두 작성한 대로 표시됩니다. 같은 패턴을 메뉴판, 가격표, 패키징에 적용할 수 있으며, 텍스트는 약 6줄 이내로 유지하세요. 가격이 모두 정확한 메뉴판을 포함한 다섯 가지 패턴의 더 많은 예시는 Seedream 5.0 Lite 프롬프트 레시피에서 확인하세요.

이미지 투 이미지: 한 곳만 변경하고 나머지는 유지

패턴: 한 문장으로 변경 사항을 설명한 다음, 반드시 변경되지 않아야 할 모든 요소를 명시하세요.

부분 색상 변경. 원본 이미지:

이 무광 화이트 세라믹 컵을 딥 코발트 블루 유약 컵으로 바꾸고, 광택 반사 질감을 추가하세요. 김, 오크 테이블, 펼친 노트북, 만년필, 다육 식물, 조명, 카메라 각도는 완전히 동일하게 유지하고, 사진처럼 사실적으로 표현하세요

seedream-5.0-lite/image-to-image, 참조 이미지 1장, 3:2, 2K, $0.035.

간판 텍스트 교체.

문 위 나무 간판의 텍스트를 'BAKERY CORNER'로 교체하고, 동일한 금색 세리프 글꼴 스타일과 글자 크기를 유지하세요. 간판 모양과 나무 결, 벽돌 외벽, 빛나는 창문, 올리브 나무, 흐린 날 조명은 완전히 동일하게 유지하고, 사진처럼 사실적으로 표현하세요

seedream-5.0-lite/image-to-image, 참조 이미지 1장, 3:2, 2K, $0.035.

두 이미지 합성. image_urls에서 이미지 순서대로 참조하세요:

첫 번째 이미지의 가죽 백팩을 두 번째 이미지의 캠핑장 장면에 있는 평평한 화강암 바위 위에 놓고, 약간 비스듬히 자연스럽게 기대어 세우세요. 따뜻한 골든 아워 햇빛에 맞게 조명을 다시 조정하고 바위 위에 부드러운 그림자를 드리우세요. 돌 화덕, 소나무 숲, 산봉우리는 그대로 유지하고, 사진처럼 사실적인 합성으로 표현하세요

seedream-5.0-lite/image-to-image, 참조 이미지 2장, 3:2, 2K, $0.035.

aspect_ratio는 입력 이미지와 동일하게 설정하세요. 다른 화면 비율을 요청하면 일부 편집 효과가 다시 잘리는 데 소모될 수 있습니다.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

taskId를 받게 됩니다. data.status가 success가 될 때까지 GET https://api.hiapi.ai/v1/tasks/{taskId}를 폴링한 다음, data.output[0].url을 다운로드하세요. 링크는 만료되므로 파일을 즉시 저장하세요.

편집을 하려면 모델을 seedream-5.0-lite/image-to-image로 변경하고 "image_urls": ["https://your-cdn.example.com/input.jpg"]를 추가하세요.

Python: 먼저 생성하고, 그다음 편집

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

나중에 결과를 재사용할 계획이라면, 각 결과가 준비되는 즉시 다운로드하세요. 출력 링크는 만료됩니다.

매개변수

필드	필수	값	설명
prompt	예	4–3,000자	렌더링할 텍스트를 따옴표로 감싸세요
aspect_ratio	예	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	편집 시 입력 이미지와 동일하게 유지
resolution	예	2K, 4K	대문자 사용, 가격 동일
image_urls	이미지 투 이미지만	URL 1–14개	jpeg, png 또는 webp, 각 최대 10 MB

seed, negative_prompt, output_format은 없습니다.

일반적인 오류

다음 오류는 모두 제출 시 HTTP 400으로 반환되므로 작업이 생성되지 않고 비용도 발생하지 않습니다:

• aspect_ratio: missing required field / resolution: missing required field: 문서에 기본값이 나열되어 있더라도 둘 다 필수입니다.
• resolution: value must be one of '2K', '4K': 1K는 없습니다. 대문자를 사용하세요.
• image_urls: maxItems: got 15, want 14: 참조 이미지는 최대 14장입니다.
• prompt: minLength: got 2, want 4: 프롬프트는 최소 4자 이상이어야 합니다.
• additional properties 'output_format' not allowed: Lite에는 해당 필드가 없습니다.

Lite, Flash, Pro 중 무엇을 선택할까?

모델	이미지당 가격	적합한 사용 사례
Seedream 5.0 Flash	$0.025	처리량과 속도가 가장 중요할 때
Seedream 5.0 Lite	2K 또는 4K 모두 $0.035	이미지 내 텍스트, 정밀 편집, 4K 추가 비용 없음
Seedream 5.0 Pro	$0.05(1K) / $0.10(2K)	최종 결과물에 최고 수준의 디테일이 필요할 때

더 저렴한 두 티어를 동일한 프롬프트로 비교한 테스트는 Seedream 5.0 Flash vs Lite 비교에서 확인하세요. 전체 가격은 Seedream 5.0 API 가격에서 확인하세요.

자주 묻는 질문

참조 이미지마다 추가 요금이 부과되나요?

아니요. 이미지 투 이미지는 참조 이미지를 1장 보내든 14장 보내든 출력 이미지당 $0.035입니다.

중국어 텍스트를 렌더링할 수 있나요?

네. 위 포스터는 한 이미지 안에 중국어 제목과 영어 부제를 동시에 포함하고 있습니다. 각 문자열을 따옴표로 감싸고 위치를 지정하면 됩니다.

제품을 완전히 동일하게 유지해 주나요?

명시한 내용은 유지됩니다. 반드시 유지해야 할 요소(모양, 라벨, 조명, 카메라 각도)를 모두 나열하세요. 언급하지 않은 내용은 변경될 수 있습니다.

2K와 4K 중 무엇을 선택해야 하나요?

가격은 동일합니다. 2K는 긴 변이 약 2,300 px, 4K는 약 4,096 px입니다. 2K 파일은 더 작아서 반복 작업 시 확인하기 편리하며, 인쇄가 필요하면 4K로 전환하세요.