Generate a portrait image from a prompt

`POST /profile/generatePortrait`

Calls the image-generation backend (Grok via the LiteLLM proxy) using the provided prompt to produce a single 512x512 portrait. The generated image is fetched into Mind's storage so the response never leaks the provider URL. Use /profile/generatePortraitPrompt first to build a polished prompt from descriptive selections.

Request body

promptstringbodyrequired

The full image-generation prompt to send to the image API

Request Example

{
  "prompt": "A cheerful watercolor portrait of a pixie at the edge of a glowing enchanted forest..."
}

Responses

200 — Successful operation

Response Example

{
  "portrait": {
    "imageUrl": "/api/mind/storage/temp/2026-04-30_a1b2c3d4e5f6g7h8.png",
    "imageBase64": "string",
    "prompt": "A cheerful watercolor portrait of a pixie..."
  }
}

400 — Missing or empty prompt

403 — Unauthorized

500 — Internal error