MAI-Image-2.5 API

Microsoft AI's MAI-Image-2.5: photorealistic generation and editing with strong in-image typography and design-ready output.

Endpoint

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

Example request

curl -X POST "https://api.hedra.com/v3/models/mai-image-2-5" \
  -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. From 3 to 5000 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.

imagesarray

The single source image to edit. Exactly 1 image, at most 30 MB.

output_formatstring

Output image format.

qualitystringrequired

Quality level to generate at.