Agent skill · software engineering · jeremylongshore
ideogram-hello-world
Generate and persist one bounded Ideogram V4 image through the current multipart endpoint. Use when testing a first server-side request or reviewing a minimal integration. Trigger with "first Ideogram image", "test Ideogram V4", or "build an Ideogram smoke test".
Why this skill is useful
Provides specific API commands and integration patterns for the Ideogram image generation service that the AI wouldn't reliably generate on its own.
What it needs
Requires jq, node, python installed locally. Requires ideogram account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
First Ideogram V4 Generation Overview Prove the smallest current Ideogram integration: one server-side multipart request, one checked response, and immediate persistence of any returned image. Keep the smoke test bounded because the call spends prepaid credit and response URLs expire. Prerequisites An approved IDEOGRAMAPIKEY, positive API credit, and a non-sensitive prompt. Server-side network access and durable storage outside the repository. A request deadline, maximum output count, and named spend owner. Current Contract The synchronous V4 route is POST /v1/ideogram-v4/generate using multipart/form-data. Supply either textprompt or jsonprompt, never both. Structured JSON prompts disable magic prompt. A result can be present but unsafe, represented by isimagesafe=false and an empty URL. Authentication Send IDEOGRAMAPIKEY only as the Api-Key header to https://api.ideogram.ai. Keep the request on a trusted server and never echo the key, prompt, response URL, or image bytes into logs or receipts. Instructions 1. Confirm the prompt classification, destination, output count, deadline, and approval for a paid live request. 2. Build a multipart body with exactly one prompt form, a supported aspect ratio, and an explicitly reviewed rendering option. 3. Send the request to the V4 synchronous route with the server-side API key and a bounded timeout. 4. Reject non-success status codes and validate the response schema before reading image fields. 5. Check isimagesafe; treat an unsafe item or empty URL as a policy outcome, not a downloadable success. 6. Download an approved image immediately, verify content type and byte limit, and store it under an application-owned opaque identifier. 7. Return content-free request, storage, timing, safety, and cleanup evidence. Tool Discipline Use Read, Glob, and Grep to inspect the existing adapter, storage boundary, and fixtures. Use Write and Edit only for approved code, fixture, or documentation changes. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/ideogram-hello-world--c68651