GPT Image 2 API

OpenAI's balanced tier; moderate cost and fidelity, ideal for iterative refinement and everyday generation.

Endpoint

POST https://api.hedra.com/v3/models/gpt-image-2

Example request

curl -X POST "https://api.hedra.com/v3/models/gpt-image-2" \
  -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. At most 32000 characters.

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.

imagesarray

Images to edit or blend. 1 to 16 images, each at most 30 MB.

output_formatstring

Output image format.

qualitystringrequired

Quality level to generate at.