Ideogram V4 API

Ideogram V4 renders poster-ready text and layout; the required quality parameter picks turbo, balanced or quality, which sets both the render effort and the price.

Endpoint

POST https://api.hedra.com/v3/models/ideogram-v4

Example request

curl -X POST "https://api.hedra.com/v3/models/ideogram-v4" \
  -H "Authorization: Key $HEDRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "a cinematic shot of a city at dusk"}}'

Parameters

promptstringrequired

Generation prompt.

num_outputsinteger

Number of outputs generated per job. Only 1 is supported.

enhance_promptboolean

Rewrite the prompt before generation. An LLM expands it into a fuller description and the model receives that text instead of the submitted one; the result's `prompt` reports what ran.

aspect_ratiostringrequired

Output aspect ratio.

resolutionstringrequired

Output resolution.

output_formatstring

Output image format.

seedinteger

Seed for reproducible output; omit for a random seed.

qualitystringrequired

Quality level to generate at.