사용 가이드
Ideogram v4.5 프롬프트 레시피: 바로 복사해 붙여넣을 수 있는 타이포그래피 프롬프트와 실제 출력
대부분의 이미지 모델은 예쁜 포스터를 그리지만 제목 철자를 틀립니다. Ideogram의 명성은 정반대입니다. 바로 글자를 제대로 씁니다. ideogram-v4.5/text-to-image는 hiapi에서 가장 최신 Ideogram 텍스트-투-이미지 모델이며, 다른 모든 모델과 마찬가지로 통합 task API 위에서 동작합니다. 이 페이지는 바로 써먹을 수 있는 프롬프트 라이브러리입니다. 로고, 포스터, 배너, 패키지를 아우르는 여섯 가지 레시피와, 제가 실제로 전송한 프롬프트 및 실제로 반환된 이미지를 함께 담았습니다. 아래의 모든 출력은 hiapi의 ideogram-v4.5/text-to-image로 생성했습니다. 스톡 이미지는 하나도 없고, 리터치한 이미지도 하나도 없습니다.
이 페이지는 또한 이 레시피들이 반복적으로 던지는 질문 하나에 답합니다. 바로 quality 등급입니다. v4.5는 세 등급—low, medium, high—으로 과금되며 가격 차이가 매우 크기 때문에, 동일한 프롬프트와 동일한 시드를 세 등급에 각각 돌리고 실제 텍스트 렌더링 결과를 비교했습니다. 결과는 예상과 다릅니다. 자세한 내용은 아래 품질 등급 섹션을 참고하세요.
범위: 이 문서는 기본 텍스트-투-이미지 엔드포인트를 다룹니다. v4.5에는 별도의 이미지-투-이미지/편집 라우트(
ideogram-v4.5/image-to-image)가 있어 마스크와 참조 이미지를 지원합니다. 이는 또 다른 스키마이며 별도 글에서 다룹니다.
v4.5가 실제로 받아들이는 스키마(생각보다 적습니다)
레시피를 살펴보기 전에 입력 계약부터 말씀드리겠습니다. v4.5의 인터페이스는 ideogram-v4와 동일하지 않기 때문입니다. 라이브 API를 대상으로 필드를 하나하나 탐색했습니다. 필요한 전부는 다음 다섯 가지입니다.
| 필드 | 타입 | 설명 |
|---|---|---|
prompt |
string, 필수 | 렌더링할 텍스트를 큰따옴표로 감싸세요(다음 절 참고). |
quality |
low / medium / high |
가격 등급. 기본 동작은 medium과 같습니다. |
num_images |
정수 1–8 | 한 작업으로 이미지 세트 전체를 반환할 수 있습니다. |
seed |
정수 | 두 프롬프트(또는 두 등급)를 공정하게 비교하려면 고정하세요. |
image_size |
열거형 | 다음 중 하나: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9. |
의외였던 점: aspect_ratio도 resolution 필드도 없습니다. v4는 aspect_ratio 문자열과 rendering_speed를 받아들였지만, v4.5는 둘 다 없앴습니다. 여섯 개 image_size 프리셋 중 하나를 골라 도형을 정하는 것이 유일한 크기 제어 수단입니다. API는 aspect_ratio, resolution, rendering_speed, magic_prompt, style_type, negative_prompt를 additional properties not allowed로 즉시 거부합니다. 따라서 v4 요청에서 마이그레이션한다면 이 필드들을 삭제하세요. 그렇지 않으면 매 호출이 400이 됩니다.
가격은 hiapi 라이브 가격 페이지에서 가져왔으며, 이미지당 과금되고 등급에 따라 달라집니다.
quality |
이미지당 가격 |
|---|---|
low |
$0.043 |
medium |
$0.086 |
high |
$0.3145 |
다음은 최소 요청입니다. 작업을 생성한 뒤 완료될 때까지 폴링합니다.
curl -s -X POST https://api.hiapi.ai/v1/tasks \
-H "Authorization: Bearer $HIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": "A clean wordmark logo, the text \"NORTHWIND ROASTERS\" in an elegant high-contrast serif, cream background, centered",
"quality": "medium",
"image_size": "square",
"num_images": 1
}
}'
# -> {"data":{"taskId":"tk-..."}}
import os, time, requests
BASE = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}
task = requests.post(BASE, headers=H, json={
"model": "ideogram-v4.5/text-to-image",
"input": {
"prompt": 'A clean wordmark logo, the text "NORTHWIND ROASTERS" '
'in an elegant high-contrast serif, cream background, centered',
"quality": "medium",
"image_size": "square",
"num_images": 1,
},
}).json()
tid = task["data"]["taskId"]
while True: # poll to a terminal state
d = requests.get(f"{BASE}/{tid}", headers=H).json()["data"]
if d["status"] in ("success", "fail"):
break
time.sleep(5)
print(d["output"][0]["url"]) # temp URL — download it right away
output[0].url은 약 일주일 후 만료되는 임시 링크이므로 바이트를 즉시 다운로드하세요. 프로덕션 환경에서 핫링크하지 마세요.
모든 레시피의 성패를 가르는 단 하나의 규칙
아래 모든 내용은 하나의 습관 위에 세워져 있습니다. 렌더링할 정확한 텍스트를 큰따옴표로 감싸고, 신경 쓰는 문구를 모델이 지어내게 두지 마세요.
Ideogram은 프롬프트를 확장합니다. 뮤직 페스티벌 포스터를 요청하면 여러분이 쓰지 않은 라인업, 날짜, 티켓 가격까지 기꺼이 추가합니다. 실제 목업을 만들 때는 유용하지만, 이런 세부 사항이 정확해야 한다면 위험합니다. 테스트에서 제가 인용한 짧은 문자열은 모두 완벽하게 철자가 맞았습니다. 오타는 모델이 스스로 지어낸 텍스트에서 나타났습니다. 그러므로 브랜드명, 제목, 버튼 텍스트, 날짜에는 따옴표를 붙이세요. 모델이 무엇을 말해도 상관없을 때만 장식적 채움을 맡기세요.
이 규칙을 익혔다면, 이제 레시피입니다.
레시피 1 — 워드마크 로고
A clean minimalist wordmark logo for a specialty coffee brand, the text "NORTHWIND ROASTERS" set in an elegant high-contrast serif, a small compass-rose icon integrated above the letter N, warm cream background, centered, flat vector-style design, generous negative space
image_size: square · quality: medium

“NORTHWIND ROASTERS”는 완벽하게 정확했고, 세리프 서체는 정말 우아했으며, 여백은 실제 브랜드 마크처럼 보였습니다. 솔직히 말씀드릴 두 가지: 모델은 나침반 장미를 “문자 N 위”가 아니라 워드마크 전체의 위쪽 중앙에 배치했습니다. v4.5는 공간 지시를 좌표가 아닌 제안으로 받아들이기 때문입니다. 그리고 제가 요청하지 않은 태그라인 “SPECIALTY COFFEE · EST. 2019”를 임의로 추가했습니다. 이 확장은 위 규칙이 말하는 동작입니다. 여기서는 편리하지만, 실제 태그라인이 다르다면 모델이 추측하게 두지 말고 명시적으로 따옴표로 적으세요.
레시피 2 — 이벤트 포스터
A vertical concert poster for an indie music festival, large headline text "ECHO VALLEY FEST" across the top, below it two lines reading "AUGUST 14-16" and "RIVERSIDE PARK", retro 1970s psychedelic palette of orange, magenta and teal, layered sunburst background, bold condensed type, high detail
image_size: portrait_4_3 · quality: medium

세 개의 인용 문자열—“ECHO VALLEY FEST”, “AUGUST 14-16”, “RIVERSIDE PARK”—이 모두 깔끔하게 렌더링되었고, portrait_4_3 도형 덕분에 제목이 숨 쉴 공간을 얻었습니다. 모델은 또한 그럴듯한 밴드 라인업과 “GATES 6PM · ALL AGES · $45 ADV / $60 DOOR” 푸터를 스스로 채워 넣었습니다. 제안용 목업에는 선물이지만, 실제 포스터라면 이 지어낸 줄을 프롬프트로 다시 가져와 통제하세요.
레시피 3 — 소셜 광고 배너
A horizontal social media ad banner for a fitness app, left-aligned headline text "MOVE MORE." in heavy bold uppercase, a smaller line reading "Start your 7-day free trial", and a rounded call-to-action button with the text "GET THE APP", energetic gradient from lime green to deep blue, clean modern UI style
image_size: landscape_16_9 · quality: medium

이것이 v4.5의 최고 성능입니다. 제목, 부제목, 버튼 텍스트라는 세 개의 독립적인 짧은 문자열이 각각 다른 UI 역할에 배치되고 모두 철자가 정확합니다. “MOVE MORE.”의 마침표까지 포함해서요. landscape_16_9 프리셋은 와이드 배너나 썸네일이 필요할 때 쓰면 됩니다. 짧고 명확하며 따옴표로 감싼 문구야말로 이 모델이 잘하는 것입니다.
레시피 4 — 제품 패키지 라벨
A product label for a bottle of artisanal hot sauce, brand name "EMBER & ASH" in a vintage woodcut serif, product line "SMOKED HABANERO" below it, a small badge reading "SMALL BATCH - 150ML", kraft-paper texture background with charcoal and ember-orange ink, symmetrical layout
image_size: square_hd · quality: medium

패키지는 가장 어려운 텍스트 테스트입니다. 작은 글자, 특수 문자, 배지까지요. 그리고 v4.5는 핵심 부분을 통과했습니다. “EMBER & ASH”는 앰퍼샌드를 정확히 렌더링했고(고전적 실패 지점), “SMOKED HABANERO”는 깔끔했으며, 목판화 스타일 하바네로는 프롬프트에 없던 멋진 추가였습니다. 작은 배지는 빗나갔습니다. “SMALL BATCH - 150ML”을 요청했지만 “SMALL BATCH · EST · 150ML”에 “BOTTLED IN SMALL BATCHES” 한 줄까지 붙어 나왔습니다. 매뉴얼의 교훈은 여전히 유효합니다. 글자가 작을수록 모델은 더 즉흥적으로 변하므로, 인쇄할 라벨이라면 초소형 문구를 짧게 유지하고 렌더링할 때마다 하나하나 확인하세요.
품질 등급 실측: low vs medium vs high
이 레시피들은 모두 medium으로 실행됩니다. 하지만 v4.5는 low / medium / high에 각각 $0.043 / $0.086 / $0.3145를 청구합니다. 무려 7배 차이입니다. 그러니 돈이 무엇을 사주는지 아는 것이 중요합니다. 의도적으로 텍스트가 빽빽한 프롬프트(밀집된 인포그래픽 포스터)를 세 등급에서 실행했고, 동일한 시드를 써서 quality만 바뀌게 했습니다.
A dense informational poster titled "CITY TRANSIT GUIDE" with three labeled columns headed "BUS", "METRO" and "TRAM", a short line of body text under each heading, clean Swiss grid layout, red and black ink on off-white paper, flat vector infographic style
low — $0.043

레이아웃과 “CITY TRANSIT GUIDE” 대제목은 선명합니다. 하지만 모델이 부제목을 지어내고 철자를 틀렸습니다. “WINTER SCHHEDULE”에 H가 하나 더 붙었습니다. 또한 노선 배지(“41”이 두 번)가 중복되었습니다. 인용한 제목(BUS/METRO/TRAM)은 문제없었습니다. 모델이 추가한 인용되지 않은 문구가 오류가 난 곳입니다.
medium — $0.086

같은 시드, 한 등급 위로. 부제목은 “WINTER SCHEDULE”로 스스로 수정되었습니다. 세 단락의 본문은 읽을 수 있고, 푸터 내비게이션(“TICKETS · ZONES · DELAYS · HELP”)도 깔끔합니다. 작은 캡션 결함(“CENTRAL”이 아닌 “CENTRHL”)이 하나 있지만, 이렇게 텍스트가 빽빽한 레이아웃에서는 분명히 셋 중 가장 깔끔한 결과입니다.
high — $0.3145

여기가 직관에 반하는 부분입니다. high가 렌더링한 디스플레이 서체—대제목, BUS/METRO/TRAM 라벨—는 세 등급 중 가장 날카롭습니다. 하지만 빽빽한 본문 단락은 자신감 넘치는 난수로 붕괴했습니다(“Mari routes runt monen downtwing...”, “tith tixve stations across five...”). medium의 3.6배 가격에 이 레이아웃에서는 본문이 더 좋아지기는커녕 더 나빠졌습니다.
결론은 모델을 깎아내리는 것이 아니라 실용적입니다. quality 등급은 v4.5가 선택한 서체를 렌더링하는 정교함을 높이지만, 모델이 여러분이 쓰지 않은 긴 문구를 지어내는 능력이 더 좋아지는 것은 아닙니다. high에서는 더 정교하게, 그리고 더 틀리게 지어낼 뿐입니다. 그러므로:
medium을 기본으로 사용하세요. 실제 텍스트가 있는 모든 작업에서 최적의 균형점이며,low가 도입한 오타를 바로잡아 줍니다.high는 주로 크고 지정된 서체의 작업—로고, 한 줄 제목 포스터—에 남겨두세요. 추가 선명도가 거기서는 가치가 있고, 환각을 일으킬 단락이 없습니다.low는 가벼운 초안과 썸네일에 적합하며, 사소한 오타는 상관없습니다.- 어떤 등급이든, 긴 본문의 철자를 모델에 의존하지 마세요. 반드시 정확해야 하는 텍스트에는 따옴표를 붙이고, 나머지는 플레이스홀더로 취급하세요.
FAQ
1080×1920 또는 정확한 픽셀 크기를 설정할 수 있나요? 아닙니다. v4.5 t2i는 여섯 개의 image_size 프리셋—square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9—만 받습니다. 너비/높이나 aspect_ratio 필드는 없습니다. 가장 가까운 프리셋을 선택하고, 정확한 비율이 필요하면 자르세요.
ideogram-v4와 어떻게 다른가요? 입력 계약이 다릅니다. v4는 aspect_ratio와 rendering_speed(turbo/balanced/quality)를 사용합니다. v4.5는 image_size 프리셋과 quality 가격 등급으로 둘 다 대체했습니다. v4의 요청 형태가 필요하다면 ideogram-v4 사용 가이드에서 다루고 있으며, 아직 타이포그래피 모델을 고르는 중이라면 ideogram-v4 vs Nano Banana 2가 도움이 될 것입니다.
기존 이미지를 편집할 수 있나요? 이 엔드포인트에서는 안 됩니다. 텍스트-투-이미지는 ideogram-v4.5/text-to-image이고, 편집(프롬프트 편집, 마스크, 참조 이미지)은 별도의 ideogram-v4.5/image-to-image 라우트입니다.
텍스트는 항상 정확한가요? 짧고 따옴표로 감싼 문자열—브랜드명, 제목, 버튼 텍스트—은 이 문서의 모든 레시피에서 신뢰할 만했습니다. 모델이 스스로 지어낸 긴 문구는 아닙니다. 렌더링할 때마다, 특히 작은 배지와 캡션은 교정하세요.
변형을 빠르게 생성하려면? 한 작업에서 num_images를 최대 8로 설정해 한 번에 세트로 받거나, seed를 고정하고 한 단어만 바꿔 동등한 조건에서 프롬프트를 비교하세요.
직접 실행해 보기
위의 모든 프롬프트는 바로 복사해 붙여넣을 수 있습니다. 따옴표로 감싼 문자열을 여러분의 브랜드, 제목, 날짜로 바꿔 전송하세요. ideogram-v4.5/text-to-image 모델 페이지에서 실시간 스키마를 확인하고, 가격 페이지에서 quality 등급을 선택하세요. task API를 처음 호출한다면 빠른 시작이 키 발급과 첫 작업 폴링을 안내합니다. 텍스트에 따옴표를 붙이고, 기본은 medium으로, 그리고 출시 전에 매 렌더링을 교정하세요.
관련 글
모든 아티클 보기 →-
사용 가이드
seedream-5.0-pro/image-to-image 시작 가이드: 기능, 가격 및 연동 핵심 포인트
ByteDance 이미지 편집 모델의 기능 경계, 과금 방식 및 엔지니어링 연동 실무
-
사용 가이드
seedream-5.0-pro 텍스트-이미지 생성 입문 가이드: 능력 경계, API 연동 및 비용 관리
개발자를 위한 실무 관점: 파라미터 핵심부터 장당 $0.05 비용 추정까지
-
사용 가이드
Hailuo 2.3 Fast 이미지-투-비디오 입문 가이드: 성능 범위, 가격 및 연동 실무
개발자를 위한 MiniMax 이미지-투-비디오 모델 선택과 연동 핵심 포인트