ideogram-upgrade-migration

# Ideogram Upgrade & Migration ## Current State !`npm list 2>/dev/null | head -10` ## Overview Guide for migrating between Ideogram API versions. The primary migration path is from the legacy `/generate` endpoint (JSON body, V_1/V_2 models) to the V3 endpoints (multipart form data, new parameters). This covers breaking changes in request format, model names, aspect ratio syntax, style types, and new capabilities. ## Breaking Changes: Legacy to V3 | Aspect | Legacy (`/generate`) | V3 (`/v1/ideogram-v3/generate`) | |--------|---------------------|--------------------------------| | Content-Type | `application/json` | `multipart/form-data` | | Body format | `{ "image_request": { ... } }` | FormData fields | | Models | `V_1`, `V_1_TURBO`, `V_2`, `V_2_TURBO`, `V_2A` | Implicit V3 (no model field) | | Aspect ratio | `ASPECT_16_9` | `16x9` | | Style types | `AUTO`, `GENERAL`, `REALISTIC`, `DESIGN`, `RENDER_3D`, `ANIME` | `AUTO`, `GENERAL`, `REALISTIC`, `DESIGN`, `FICTION` | | Magic prompt | `magic_prompt_option` | `magic_prompt` | | New in V3 | -- | `rendering_speed`, `style_preset`, `style_codes`, `character_reference_images` | | Color palette | Preset name or hex array | Same, with weight support | ## Instructions ### Step 1: Audit Current API Usage ```bash set -euo pipefail # Find all Ideogram API calls in your codebase grep -rn "api.ideogram.ai" --include="*.ts" --include="*.js" --include="*.py" . grep -rn "ASPECT_" --include="*.ts" --include="*.js" . grep -rn "image_reque...