# Image Generation — BrandApp Playground

> Prompt-based image generation with optional style and aspect ratio, reporting credit cost.

- Canonical page: https://brandapp-playground.vercel.app/ai/image
- Markdown: https://brandapp-playground.vercel.app/ai/image.md
- SDK module: `@reopt-ai/brandapp-sdk/ai`

## API

```ts
const result = await ai.generateImage({
  prompt: "a topographic map of a coastline",
  style: "watercolor",   // optional
  aspectRatio: "16:9",   // 1:1 | 16:9 | 9:16 | 4:3 | 3:4
});
// → { url, size, usage: { creditCost }, creditsRemaining }
```

Generated images land in the BrandApp's file store, so they also appear on the Files page.

## Related

- [Credits and Models](https://brandapp-playground.vercel.app/ai/credits.md)
- [Files API](https://brandapp-playground.vercel.app/files.md)

---

Index of every document: https://brandapp-playground.vercel.app/llms.txt
Single-file copy: https://brandapp-playground.vercel.app/llms-full.txt
HTTP API description: https://brandapp-playground.vercel.app/openapi.json