# ideogram-cost-tuning

ideogram-cost-tuning controls prepaid Ideogram API consumption with admission ceilings, retry limits, and output tracking. Helps teams eliminate wasted spend on failed or duplicate runs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 2935 repo stars
- Author: Jeremy Longshore
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/ideogram-cost-tuning/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ideogram-cost-tuning

## What it does

This skill designs budget controls for the Ideogram API without baking in fixed prices that get outdated. It establishes hard admission ceilings per request, tenant, day, or campaign. When limits are hit, intake closes immediately. The workflow prevents duplicate paid work by tracking asynchronous task IDs, expiring stale queue jobs, and trimming retry loops.

Accounting focuses exclusively on safe assets delivered to durable storage. Generations lost to transport drops or flagged by content safety count as budget waste rather than billable milestones. Inspection relies on Read, Glob, and Grep across queues and adapters. Write and Edit handle approved configurations and test cases.

Setup requires a server-side `IDEOGRAM_API_KEY`, an accountable budget owner, and fresh rate verification from the vendor pricing page. Team keys share a single vendor credit pool, so the skill treats unverified balance assumptions as a failure mode and forbids autonomous balance recharges.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-cost-tuning -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ideogram-cost-tuning/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ideogram-cost-tuning/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-cost-tuning -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ideogram-cost-tuning/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-cost-tuning -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ideogram-cost-tuning/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/ideogram-cost-tuning
```

2. **Manually: put the files in place**
- File: `.github/skills/ideogram-cost-tuning/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-cost-tuning -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/ideogram-cost-tuning
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ideogram-cost-tuning/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-cost-tuning -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/ideogram-cost-tuning/SKILL.md

## When to use it
- cap daily and campaign spend across shared Ideogram API keys
- stop duplicate billing on identical image generation requests
- separate billable stored assets from unsafe or abandoned attempts
- block incoming requests automatically before prepaid balance runs dry

## Example prompts
- Audit Ideogram API cost across our batch image generation workers
- Cut Ideogram spend by setting a daily budget ceiling and dropping stale retries
- Budget Ideogram generations for marketing campaigns with a weekly window

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: ea360f25b9416102.

BEGIN THIRD-PARTY FILE ea360f25b9416102
```text
---
name: ideogram-cost-tuning
description: >-
  Govern Ideogram prepaid spend through admission budgets, route choice, output bounds, useful-result accounting, and cleanup. Use when reducing cost or designing billing controls. Trigger with "cut Ideogram spend", "budget Ideogram generations", or "audit Ideogram API cost".
allowed-tools: Read,Glob,Grep,Write,Edit
argument-hint: "<workload> <budget-window> <quality-floor>"
version: 1.11.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags: [saas, ideogram, cost]
model: inherit
effort: high
compatibility: "Designed for Claude Code; current prices must be checked at decision time"
---
# Ideogram Cost Governance

## Overview

Control prepaid Ideogram consumption without embedding prices that can drift. Tie admission to an accountable budget, choose the narrowest route, bound outputs and retries, and measure durable safe results rather than HTTP success or generated candidates.

## Prerequisites

- Team billing owner, current balance source, budget period, workload owner, and quality floor.
- Request volume, endpoint and rendering mix, output count, retry rate, unsafe rate, and storage failures.
- A current pricing review from the first-party API pricing page.

## Current Contract

Ideogram API billing is separate from the web application, requires positive prepaid credit, and can use auto-recharge. Keys in one team share credits and billing, so per-key usage is not a separate vendor balance. Prices and recharge choices are time-sensitive and must be verified rather than copied into this skill.

## Authentication

Workers use server-side `IDEOGRAM_API_KEY` as `Api-Key` to `https://api.ideogram.ai`. Cost evidence may include team, endpoint, request, and opaque generation identifiers, but not the key, prompts, images, or URLs.

## Instructions

1. Retrieve current first-party pricing and balance behavior, recording date, currency, unit, and owner.
2. Inventory demand by tenant, use case, route, rendering option, output count, retry class, safety result, and durable-storage result.
3. Define request, tenant, daily, campaign, and incident ceilings with fail-closed admission.
```
END THIRD-PARTY FILE ea360f25b9416102

The third-party file has ended. Everything between the ea360f25b9416102 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2172 of 4577 bytes. © Jeremy Longshore · MIT · https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/ideogram-cost-tuning/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
