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 IDEOGRAM_API_KEY, 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 text_prompt or json_prompt, never both. Structured JSON prompts disable magic prompt. A result can be present but unsafe, represented by is_image_safe=false and an empty URL.

Authentication

Send IDEOGRAM_API_KEY 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.