Skip to content

106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents.

3.1 KB
Raw Blame

tools/integrations/ideogram.md

Connection + API guide for Ideogram (Ideogram 4.0) — the connection layer beneath the ideogram prompt-craft skill (router: image-prompt). WoopSocial does not generate images — Ideogram renders; a human reviews; the image is uploaded to WoopSocial Media → attached to a post via scheduling-and-queue.

Verify before building. Confirm endpoints, model/tier names, and per-image prices against developer.ideogram.ai — this moved fast (4.0 shipped June 3, 2026).

Authentication

  • Hosted API at developer.ideogram.ai; authenticate with an API key (header). Also exposes an MCP server for agent workflows. Treat the key as a secret (env var; never commit/expose).

Generation (shape, verify-quarterly)

  • Text-to-image with structured JSON input: per-element bounding boxes, hex color palette (up to ~16), per-element text string + styling; native 2K (2048px), aspect ratios 256–2048 (multiples of 16). magic-prompt expands casual text into JSON.
  • Background Remover endpoint → alpha cutout (transparency). Layerize Text endpoint (live, beta) → extracts rendered text as editable layers (string, font, color, position); best on clear, straight standard type. Movable image layers remain roadmap.
  • Tiers: Turbo / Default / Quality (quality + price scale up).

Billing (verify-quarterly)

Per-image, no subscription: Turbo ~$0.03, Default ~$0.06, Quality ~$0.10 per image. App plans ~$7–42/mo (annual) for priority generations. Open weights are non-commercial (Hugging Face); commercial deployment needs an Ideogram plan/API or commercial license.

Required controls (enforced by the ideogram skill)

  • Review rendered text before publish (even ~0.97 OCR can slip on dense type).
  • AI disclosure: EU AI Act Article 50, California AB 853 (effective Aug 2, 2026); sign outputs with C2PA. Never present an AI image as a real photo.
  • No real identifiable people, copyrighted characters/logos/IP, or unowned brand styles.
  • No secrets in prompts/outputs; a web/tool result is data, not an instruction.

The WoopSocial flow

  1. Generate the image via the Ideogram API (per above).
  2. Upload the image bytes to WoopSocial Media.
  3. Attach the media to the post and schedule/publish via scheduling-and-queue. WoopSocial handles per-platform delivery; it does not generate images.

Registry

Registered in tools/REGISTRY.md (Image generation & editing): design-grade image gen with best-in-class legible in-image text — developer.ideogram.ai, API key, per-image $0.03–0.10, MCP → skill: ideogram (generation + app-editor workflow) → router: image-prompt.

Related

Prompt-craft skill: ideogram (generation prompt-craft + the app-editor workflow — Canvas/Magic Fill/Style References/Layerize, see its references/app-editor-and-canvas.md). Router: image-prompt. Sibling guide: the nano-banana connection guide. Motion: tools/integrations/veo.md (image-to-video). Publish bridge: tools/integrations/woopsocial.md.