Skip to main content
The Images API creates finished images, non-destructive edits, and reusable visual inputs for other Mint services.

​
Generate an Image

Call POST /v1/images:generate with prompt and optional name or generationPreset. Mint derives a title when name is omitted; choose a preset for the desired speed, quality, and cost.
Image generation returns a finished resource and does not use generationMode.

​
Edit an Image

Call POST /v1/images/{imageId}:edit with editInstruction. The edit is non-destructive and creates a new Image.

​
Upload a reference image

Call POST /v1/reference-images with exactly one source form:
  • sourceUrl: a public HTTPS image URL.
  • base64Data with fileName and contentType.
Add name for an optional title shown in Mint. Do not use private-network, localhost, short-lived authenticated, or untrusted redirect URLs.

​
Retrieve Images and files

Use GET /v1/images/{imageId} or GET /v1/reference-images/{referenceImageId}. Use the Assets routes when you need a complete file manifest or download URL.