Files
Conal Mullan 6cb64ef067 Add Ideogram 4 text-to-image (best-in-class in-image text) (#28)
* FEAT: add Ideogram 4 text-to-image (best-in-class in-image text rendering)

New `tools/ideogram4.py` generates images via Ideogram's hosted v4 API —
its strength is legible baked-in text (title cards, thumbnails, CTAs, quote
cards, in-scene signage), exact hex color palettes, and bounding-box layout,
where FLUX.2 and LTX-2 both garble text.

- Thin multipart wrapper over POST /v1/ideogram-v4/generate (Api-Key header).
  Mutually-exclusive --json (structured json_prompt, the quality path) and
  --prompt (text_prompt, server-side magic prompt). --brand injects brand.json
  hex colors into the caption palette; --speed FLASH/TURBO/DEFAULT/QUALITY.
- New `ideogram4` skill (.claude/skills/ideogram4/) teaching the structured
  JSON caption format — Claude acts as the magic-prompt expander (beats the
  weaker free hosted one). SKILL.md + prompting.md + examples.md.
- Hosted paid API chosen over self-hosting: the v4 weights are non-commercial,
  the API includes a commercial license, and the API's json_prompt preserves
  the full prompting-skill value (~$0.03-0.09/image).
- get_ideogram_api_key() in tools/config.py; registry entries for skill+tool.
- CLAUDE.md: FLUX.2-vs-Ideogram-4 decision guidance (baked-in text vs.
  background-for-Remotion-overlay).

Tested live: json_prompt title card and text_prompt thumbnail both render with
crisp legible text; resolution 2048x2048 accepted. Closes #25.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* DOCS: refresh ideogram4 registry notes (tool built + live-tested)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 20:28:54 +01:00
..