---
title: "Generate Image Endpoint"
method: POST
path: "/v1/assets/image/generate"
tags: ["assets"]
---

# Generate Image Endpoint

`POST /v1/assets/image/generate`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/assets/image/generate`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Generate an image via AI and store as a persistent asset.

Wraps the existing generate_image() pipeline (used internally by creative mode)
and returns an asset_id that the Image spec component can consume.

Model selection precedence:
  1. Explicit `model` (gateway model ID) wins.
  2. Else `quality` ('draft' | 'balanced' | 'premium') maps via QUALITY_TIER_MODELS.
  3. Else defaults to 'balanced' (QUALITY_TIER_MODELS['balanced']).

$0.05/generation (flat — independent of model tier for now).
Size options: 1024x1024 (square), 1792x1024 (wide), 1024x1792 (tall).

## Request body

- ImageGenerateRequest
  - `prompt` string, required
  - `size` string
  - `model` string, nullable
  - `quality` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/slideforge/apis/slideforge-api.md) · [All operations](https://skmtc.dev/slideforge/apis/slideforge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slideforge/apis/slideforge-api/revisions/ae698e3d3c00?raw)