ideogram-hello-world

# Ideogram Hello World ## Overview Generate your first AI image with Ideogram. Demonstrates the legacy `/generate` endpoint (JSON body) and the V3 `/v1/ideogram-v3/generate` endpoint (multipart form). Both return temporary image URLs that must be downloaded promptly. ## Prerequisites - Completed `ideogram-install-auth` setup - `IDEOGRAM_API_KEY` environment variable set - Node.js 18+ or Python 3.10+ ## Instructions ### Step 1: Quick Test with curl ```bash set -euo pipefail # Legacy endpoint (V_2 model, JSON body) curl -s -X POST https://api.ideogram.ai/generate \ -H "Api-Key: $IDEOGRAM_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "image_request": { "prompt": "A cheerful golden retriever wearing sunglasses on a beach, with text saying \"Hello Ideogram!\"", "model": "V_2", "style_type": "REALISTIC", "aspect_ratio": "ASPECT_16_9", "magic_prompt_option": "AUTO" } }' | jq '.data[0] | {url, seed, resolution, is_image_safe}' ``` ### Step 2: TypeScript -- Generate and Download ```typescript // hello-ideogram.ts import { writeFileSync } from "fs"; async function helloIdeogram() { // Generate an image with embedded text (Ideogram's specialty) const response = await fetch("https://api.ideogram.ai/generate", { method: "POST", headers: { "Api-Key": process.env.IDEOGRAM_API_KEY!, "Content-Type": "application/json", }, body: JSON.stringify({ image_request: { prompt: 'Modern poster des...