Ideogram 4 스킬
Ideogram 4(9.3B, 오픈 웨이트, 2026년 6월 출시)를 사용한 텍스트-이미지 생성. 이 모델의 특장점은 이미지 내 텍스트 렌더링 최고 수준 — 훨씬 큰 모델(FLUX.2 dev 32B, Qwen-Image 20B, Hunyuan 80B)보다 읽기 쉬운 간판, 로고, 캡션, 여러 줄 텍스트를 더 잘 생성합니다 — 그리고 정확한 색상 팔레트 및 바운딩 박스 제어입니다.
이러한 장점은 구조화된 JSON 캡션 형식에 달려 있습니다. 일반 텍스트 프롬프트로는 FLUX 수준의 결과만 얻을 뿐, 이 모델을 사용하는 의미가 사라집니다. 이 스킬은 Claude가 "매직 프롬프트" 확장기 역할을 하여 사용자의 일반적인 요청을 Ideogram 4가 학습한 JSON 캡션으로 변환하도록 가르칩니다.
백엔드: 이 툴킷은 Ideogram의 호스팅 v4 API(자체 호스팅 웨이트 아님)를 사용합니다. API는 구조화된
json_prompt를 허용하므로, 이 스킬이 가르치는 모든 내용이 직접 적용됩니다 — Claude가 캡션을 구성하고, 도구가 이를json_prompt로 전송합니다. 유료 API 플랜에는 상업 라이선스가 포함되어 있으며, 자체 호스팅 가능한 웨이트(비상업적)에는 포함되어 있지 않습니다 — 이것이 API를 사용하는 이유입니다. 비용은 약 $0.03/이미지(터보) ~ $0.10/이미지(품질)입니다.
이 스킬을 사용해야 하는 경우
다음과 같은 경우 FLUX.2 대신 Ideogram 4를 사용하세요:
- 이미지 내 텍스트가 읽기 쉬워야 하는 경우 — 제목 카드, 썸네일, 하단 써드(자막) 배경, 간판, 로고, 인용 카드, 헤드라인이 포함된 CTA
- 정확한 브랜드 색상이 필요한 경우 — 요소별 16진수 색상 팔레트 조건 설정
- 제어된 레이아웃이 필요한 경우 — 바운딩 박스로 텍스트/객체를 특정 영역에 배치
- 이미지 내 다국어 텍스트가 필요한 경우
다음과 같은 경우 FLUX.2를 사용하세요: 이미지에 중요한 텍스트가 없거나, 상업 라이선스 출력이 필요하거나, 빠른 분위기 배경 이미지만 필요한 경우. FLUX는 일반 자연어 프롬프트를 받고, Ideogram은 JSON을 원합니다. tools/flux2.py를 참조하세요.
반드시 지켜야 할 한 가지
항상 구조화된 JSON 캡션을 출력하고, 일반 문장을 출력하지 마세요. 이 모델은 모든 요소를 명시적으로 명명하는 JSON 캡션만으로 독점적으로 훈련되었습니다. Claude는 Ideogram의 무료 호스팅 매직 프롬프트보다 더 나은 확장기입니다(자체 문서에서도 배포된 매직 프롬프트가 "프로덕션에서 사용되는 것과 동일하지 않다"고 언급합니다). 따라서 원시 텍스트를 전달하는 대신 이 스킬을 사용하여 직접 캡션을 구성하세요.
최소 유효 캡션:
{"high_level_description":"잔잔한 물 위의 일몰 속 범선.","style_description":{"aesthetics":"고요함, 따뜻함, 황금 시간","lighting":"황금 시간 역광","photo":"광각, f/8","medium":"사진","color_palette":["#FF6B35","#F7C59F","#004E89"]},"compositional_deconstruction":{"background":"낮은 수평선과 주황-분홍 하늘이 있는 잔잔한 바다.","elements":[{"type":"obj","desc":"지는 해를 배경으로 실루엣으로 드러난 흰색 삼각형 돛."}]}}
전체 스키마, 엄격한 키 순서 규칙 및 bbox 좌표 시스템은 **prompting.md**에 있습니다. 제목 카드/썸네일/인용 카드 예제는 **examples.md**에 있습니다.
빠른 참조 — tools/ideogram4.py
Ideogram의 호스팅 v4 API에 대한 얇은 래퍼.
.env파일에IDEOGRAM_API_KEY가 필요합니다(키는 developer.ideogram.ai에서 발급).--json은 캡션을 API의json_prompt필드로 전송하고(서버 측 매직 프롬프트 없음 — Claude가 확장기),--prompt는text_prompt를 전송합니다.
# 직접 작성한 JSON 캡션 (텍스트/레이아웃에 권장) — Claude가 caption.json을 작성
uv run tools/ideogram4.py --json caption.json --output title.png
# stdin에서 캡션 읽기 (Claude가 직접 파이프 가능)
cat caption.json | uv run tools/ideogram4.py --json - --output title.png
# 일반 프롬프트 — Ideogram의 서버 측 매직 프롬프트가 확장 (약함; --json 권장)
uv run tools/ideogram4.py --prompt "제목 카드: 'AI 엔지니어링 리뷰' 진한 흰색 어두운 배경" --output title.png
# 캡션 팔레트에 브랜드 16진수 색상 주입 (JSON 모드)
uv run tools/ideogram4.py --json caption.json --brand digital-samba --output cta.png
# 품질 등급 + 해상도
uv run tools/ideogram4.py --json caption.json --speed QUALITY --resolution 2048x2048 --output slide.png
Ideogram 4.5 (옵트인)
--model 4.5는 동일한 플래그를 v2 API(POST /v2/image/generate/ideogram-4-5, v1 호출과 동일한 멀티파트)의 Ideogram 4.5에 전송합니다. 실제로 실행되었습니다: JSON 캡션은 거의 완벽한 텍스트를 렌더링하지만, 일반 프롬프트는 잘못된 채우기 텍스트를 추가하므로 항상 4.5에 JSON 캡션을 전송하세요. Ideogram 4가 기본값으로 유지되는 이유는 4.5의 크기가 32의 배수여야 하므로 정확한 YouTube 1280x720을 사용할 수 없기 때문입니다(/thumbnail은 그를 위해 4.0을 사용합니다).
uv run tools/ideogram4.py --model 4.5 --json caption.json --speed QUALITY --resolution 1440x2560 --output card.png
-
프롬프트: 두 모드 모두 4.5의 단일
prompt필드에 들어갑니다.--json은 캡션을 컴팩트 JSON으로 전송합니다. 4.5는 Ideogram 4 캡션 형식을 읽으며, 유효한 캡션은 서버 측 매직 프롬프트를 건너뜁니다.--prompt텍스트는 v1과 마찬가지로 매직 프롬프트에 의해 확장됩니다. -
--speed는quality로 매핑됩니다: TURBO, DEFAULT 및 QUALITY는 Ideogram 4와 동일한 가격이며, FLASH(Ideogram 4 가격 없음)는 low로 매핑됩니다(Ideogram의 게시된 가격, 2026-10-12 확인, 1K 및 2K 크기는 동일 가격):--speed4.5 quality이미지당 비용 FLASH, TURBO low$0.03 DEFAULT (기본값) medium$0.06 QUALITY high$0.10 4.5의
very_low등급은 소스 이미지가 필요하므로 도구가 이를 전송하지 않습니다.--model 4에서는 FLASH가 여전히 그대로 전송되지만, Ideogram 문서에 따르면 현재 HTTP 400을 반환합니다. -
--resolution은size로 전송됩니다:auto, 또는 WIDTHxHEIGHT(양쪽 모두 32의 배수이고 최소 256px, 최대 총 2048x2048 픽셀, 종횡비 최대 6:1). 생략하면 Ideogram이 프롬프트에서 크기를 선택합니다. 도구는 API 호출 전에 이러한 규칙을 확인하고 위반 시 종료 코드 2로 종료합니다.1440x2560(9:16 카드 크기) 및2048x2048은 통과합니다. 6개의 Ideogram 4 사전 설정은 통과하지 못하며, 오류는 대체 크기를 제안합니다: 720x1280(1440x2560), 1280x720(2560x1440), 720x1440(1440x2880), 1440x720(2880x1440), 1296x3168(1280x3072), 3168x1296(3072x1280). 소스 이미지 없이 Ideogram은 또한 게시되지 않은 지원되는 1K/2K 사전 설정 중 하나가 필요하므로, 검사를 통과한 크기도 HTTP 400을 받을 수 있습니다.
주요 파일
prompting.md— 전체 JSON 스키마, 엄격한 키 순서, bbox 좌표 시스템, 팔레트 규칙examples.md— 제목 카드, 썸네일, 인용 카드, 브랜드 CTA에 대한 예제 캡션
비디오 제작 적합성
Ideogram 4가 이 툴킷에서 차지하는 위치는 텍스트가 포함된 슬라이드 및 썸네일입니다. FLUX와 LTX-2는 이 부분에서 실패합니다(둘 다 왜곡된 텍스트를 렌더링합니다). 자연스러운 조합:
| 사용 사례 | Ideogram 4를 사용하는 이유 |
|---|---|
| 헤드라인 텍스트가 포함된 제목 카드/CTA 배경 | 한 번에 읽기 쉬운 텍스트 + 정확한 브랜드 16진수 색상 |
| 강력한 문구가 있는 YouTube/소셜 썸네일 | 큰 읽기 쉬운 텍스트가 가장 강력한 장점 |
| 인용 카드/통계 카드 | 여러 줄 텍스트 + bbox를 통한 레이아웃 제어 |
| 제품 데모 장면 내 간판/로고 | 다른 모델이 렌더링할 수 없는 이미지 내 텍스트 |
그런 다음 정적 이미지를 Remotion(<OffthreadVideo>/Img)에 넣거나 tools/ltx2.py --input으로 애니메이션화합니다.