ideogram-data-handling

# Ideogram Data Handling ## Overview Manage generated image assets from Ideogram's API. Critical concern: **Ideogram image URLs expire** (approximately 1 hour). Every generation must be downloaded and persisted immediately. This skill covers metadata tracking, download pipelines, local and cloud storage, lifecycle management, and generation history for reproducibility. ## Prerequisites - `IDEOGRAM_API_KEY` configured - Storage solution (local filesystem, S3, or GCS) - Database for generation metadata (SQLite, Postgres, or JSON files) ## Instructions ### Step 1: Generation Record Schema ```typescript interface GenerationRecord { id: string; // Unique identifier prompt: string; // Original prompt expandedPrompt?: string; // Magic Prompt expansion (from response) negativePrompt?: string; // Negative prompt used model: string; // V_2, V_2_TURBO, etc. styleType: string; // DESIGN, REALISTIC, etc. aspectRatio: string; // ASPECT_16_9, etc. seed: number; // For reproducibility resolution: string; // e.g., "1024x1024" isSafe: boolean; // is_image_safe from response originalUrl: string; // Temporary Ideogram URL storedPath: string; // Local or S3 path createdAt: string; // ISO timestamp sizeBytes?: number; // Downloaded file size tags?: string[]; // User-defined tags } ``` ### Step 2: Generate, Download, and Track ```typescript i...