---
title: "Generate minimalist visual from text"
method: POST
path: "/api/v1/minimalist-visual"
tags: ["Minimalist Visual"]
---

# Generate minimalist visual from text

`POST /api/v1/minimalist-visual`

## Request

- Base URL: `https://app.supermeme.ai`
- URL: `https://app.supermeme.ai/api/v1/minimalist-visual`
- Auth: HTTP bearer

Generates minimalistic visual illustrations from a user text or idea. Returned URLs are signed and expire after 1 hour (see `expiresAt`) — download or re-host promptly.

## Request body

- object
  - `text` string, required: The text or idea to visualize
  - `count` number: Number of visuals to generate (1-3, default: 1)
  - `aspectRatio` '1:1' | '3:4' | '4:3' | '9:16' | '16:9': Aspect ratio for the generated images (default: 1:1)

## Response `200`

Visuals generated successfully

- MinimalistVisualResponse
  - `images` string[], required: Signed URLs of the generated minimalist illustrations
  - `expiresAt` string, required: Conservative ISO 8601 expiry for the returned image URLs (signed with a 1-hour TTL). The URLs are guaranteed valid until this time; treat them as expired after it.

## Other responses

- `400`: Bad request — invalid or missing parameters (`type: validation_error`)
- `401`: Missing or invalid API key (`type: unauthorized`)
- `403`: The subscription does not include API access (`type: forbidden`)
- `429`: Monthly request quota exhausted (`type: quota_exceeded`). The `X-RateLimit-Reset` header says when the quota resets.
- `500`: Internal server error (`type: internal_error`)

---

[API](https://skmtc.dev/supermeme/apis/supermeme-ai-meme-api.md) - [All operations](https://skmtc.dev/supermeme/apis/supermeme-ai-meme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/supermeme/apis/supermeme-ai-meme-api/revisions/7444fbdcb9c4?raw)