Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/ideogram-install-auth/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-install-auth. Copyright stays with the author (MIT).

Ideogram Install & Auth

Overview

Set up Ideogram API authentication for AI image generation. Ideogram provides a REST API at api.ideogram.ai for text-to-image generation, editing, remixing, upscaling, and describing images. Authentication uses an Api-Key header on every request.

Prerequisites

• Node.js 18+ or Python 3.10+
• Ideogram account at ideogram.ai
• API key from Ideogram dashboard (Settings > API Beta)
• Payment method configured (auto top-up billing)

Instructions

Step 1: Get Your API Key

1. Log into ideogram.ai
2. Navigate to Settings (burger icon) > API Beta
3. Accept the Developer API Agreement
4. Click Manage Payment and add billing info via Stripe
5. Click Create API key -- store it immediately, it is shown only once

Step 2: Install HTTP Client

set -euo pipefail
# Node.js (no SDK required -- Ideogram uses a plain REST API)
npm install dotenv

# Python
pip install requests python-dotenv

Step 3: Configure Authentication

# Create .env file (NEVER commit to git)
echo 'IDEOGRAM_API_KEY=your-api-key-here' >> .env

# Add to .gitignore
echo '.env' >> .gitignore
echo '.env.local' >> .gitignore

Step 4: Verify Connection

// verify-ideogram.ts
import "dotenv/config";

async function verifyIdeogramAuth() {
  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: "A simple blue circle on white background",
        model: "V_2_TURBO",
        aspect_ratio: "ASPECT_1_1",
        magic_prompt_option: "OFF",
      },
    }),
  });

  if (response.ok) {
    const result = await response.json();
    console.log("Auth verified. Image URL:", result.data[0].url);
    console.log("Seed:", result.data[0].seed);
  } else {
    const err = await response.text();
    console.error(`Auth failed (${response.status}):`, err);
  }
}

verifyIdeogramAuth();

# verify_ideogram.py
import os, requests
from dotenv import load_dotenv

load_dotenv()

response = requests.post(
    "https://api.ideogram.ai/generate",
    headers={
        "Api-Key": os.environ["IDEOGRAM_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "image_request": {
            "prompt": "A simple blue circle on white background",
            "model": "V_2_TURBO",
            "aspect_ratio": "ASPECT_1_1",
            "magic_prompt_option": "OFF",
        }
    },
)

if response.ok:
    data = response.json()
    print("Auth verified. Image URL:", data["data"][0]["url"])
else:
    print(f"Auth failed ({response.status_code}):", response.text)

API Base URLs

Billing Model

• Auto top-up: balance refills to $20 when it drops below $10 (configurable)
• Default rate limit: 10 in-flight requests
• Image URLs expire -- download immediately after generation
• Enterprise: contact partnership@ideogram.ai for higher limits

Error Handling

Output

• Environment variable IDEOGRAM_API_KEY configured
• .env file with key (git-ignored)
• Successful test generation confirming connectivity

Examples

env=sandbox; secret_ref=ideogram-client-v4; scope=generation; destination=approved; synthetic_probe=200; output_retention=none; rotation_owner=platform-ops proves setup without exposing a credential.

Resources

• Ideogram Developer Docs
• API Reference
• API Setup Guide
• API Pricing

Next Steps

After successful auth, proceed to ideogram-hello-world for your first real generation.