ideogram-sdk-patterns

# Ideogram SDK Patterns ## Overview Production-ready patterns for Ideogram's REST API. Since Ideogram has no official SDK, these patterns provide type-safe wrappers, retry logic, response validation, and multi-tenant support for the `api.ideogram.ai` endpoints. ## Prerequisites - Completed `ideogram-install-auth` setup - Familiarity with async/await and fetch API - Understanding of Ideogram response lifecycle (URLs expire) ## Instructions ### Step 1: Singleton Client with Auto-Download ```typescript // src/ideogram/client.ts import { writeFileSync, mkdirSync } from "fs"; import { join } from "path"; const API_BASE = "https://api.ideogram.ai"; let instance: IdeogramClient | null = null; export function getIdeogramClient(): IdeogramClient { if (!instance) { const key = process.env.IDEOGRAM_API_KEY; if (!key) throw new Error("IDEOGRAM_API_KEY not set"); instance = new IdeogramClient(key); } return instance; } export class IdeogramClient { constructor(private apiKey: string) {} async generate(prompt: string, options: { model?: string; style_type?: string; aspect_ratio?: string; negative_prompt?: string; magic_prompt_option?: string; num_images?: number; seed?: number; } = {}) { const response = await fetch(`${API_BASE}/generate`, { method: "POST", headers: { "Api-Key": this.apiKey, "Content-Type": "application/json" }, body: JSON.stringify({ image_request: { prompt, mode...