---
title: "Make this photo, text, web page or document into a designed slide"
method: POST
path: "/v1/slideshows/{id}/slides/ai"
tags: ["Slideshows"]
---

# Make this photo, text, web page or document into a designed slide

`POST /v1/slideshows/{id}/slides/ai`

## Request

- Base URL: `https://infoslides.app`
- URL: `https://infoslides.app/v1/slideshows/{id}/slides/ai`
- Auth: none declared

AI Studio: designs new slides for this slideshow in the workspace's style. `handler` picks the input: `prompt` (describe the slide in `prompt`: headline, details, prices, times; the copy is written from it), `photo` (a picture of a poster, whiteboard, menu or flyer in `mediaAssetId` or `mediaUrl`; its text is read and laid out as a clean slide), `url` (a page in `url`; its key information is put on a slide) or `document` (a PDF or Word file in `mediaAssetId`, uploaded with `POST /v1/media` first; becomes a few slides of key points). Design options: `branding` (`true` features the logo and brand colour, `false` keeps branding subtle, omit to let the prompt decide; with a confirmed brand guide, omitting it means `true`, and the guide's colours, fonts, voice and banned phrases are applied), `background` (`auto` lets AI Studio decide, `none` for a plain colour, `photo` for a stock photo described by `backgroundDescription`; on `prompt`, a `mediaAssetId` image is used as the background instead). Returns at once (202) with `statusUrl`; poll it at most every 5 seconds, typically for 10 to 60 seconds. With `insert: false` (default) the job stops at `Ready` with `previews` (PNG links to show the person) and an `insertUrl`; with `insert: true` the slides are added straight away (`Inserted`, with `insertedSlideIds`). Same plan, trial and credit limits as AI Studio in the web app: `EntitlementRequired` with `upgradeUrl` when the plan or trial does not cover it or the credit limit is reached. The trial covers `prompt` only. To show a photo as it is, add it with `POST /v1/slideshows/{id}/slides` instead.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- V1AiSlideRequest
  - `handler` string, nullable
  - `prompt` string, nullable
  - `url` string, nullable
  - `mediaAssetId` string, uuid, nullable
  - `mediaUrl` string, nullable
  - `branding` boolean, nullable
  - `background` string, nullable
  - `backgroundDescription` string, nullable
  - `insert` boolean, nullable
  - `position` integer, nullable

## Response `200`

OK

---

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