# Visual Templates

Create images and videos using pre-built templates with the [Create Visual API endpoint](/api/create-video.md).

## How to Use Templates

1. Choose a template from the categories below
2. Copy the UUID from the template ID (e.g., from `/base/v2/quote-card/77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd/v1`, use `77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd`)
3. Send a POST request to `/v2/videos/from-templates` with the UUID as `templateId`, set `inputs` to `{}`, and describe what you want in `prompt`

### Example Request

Use the `prompt` parameter to describe what you want. Set `inputs` to `{}`. AI fills in the template inputs automatically.

Use the bare UUID as the `templateId` (not the full path).

```json
POST https://backend.blotato.com/v2/videos/from-templates
Content-Type: application/json
blotato-api-key: YOUR_API_KEY

{
  "templateId": "77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd",
  "inputs": {},
  "prompt": "Create 5 motivational quotes about entrepreneurship",
  "render": true
}
```

### LLM-Friendly Reference

For LLM integrations, see [API Reference for LLMs](/api/llm.md) for a plain text reference with all endpoints and parameters.

***

## Image Slideshows

Create image slideshows with text overlays. Images uploaded or AI-generated.

| Template                                                                                   | ID                                                                 | Output    |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ | --------- |
| [Image Slideshow with Text Overlays](/api/visuals/5903b592-1255-43b4-b9ac-f8ed7cbf6a5f.md) | `/base/v2/image-slideshow/5903b592-1255-43b4-b9ac-f8ed7cbf6a5f/v1` | Slideshow |
| [Instagram Carousel Slideshow](/api/visuals/53cfec04-2500-41cf-8cc1-ba670d2c341a.md)       | `53cfec04-2500-41cf-8cc1-ba670d2c341a`                             | Slideshow |

***

## Quote Cards

Quote card carousels with various background styles.

| Template                                                                                               | ID                                                            | Output    |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | --------- |
| [Quote Card with Monocolor Background](/api/visuals/77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd.md)           | `/base/v2/quote-card/77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd/v1` | Slideshow |
| [Quote Card with Paper Background and Highlight](/api/visuals/f941e306-76f7-45da-b3d9-7463af630e91.md) | `/base/v2/quote-card/f941e306-76f7-45da-b3d9-7463af630e91/v1` | Slideshow |

***

## Tweet Cards

Twitter/X-style quote cards with minimal or photo/video backgrounds.

| Template                                                                                       | ID                                                            | Output    |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------- |
| [Tweet Card with Minimal Style](/api/visuals/ba413be6-a840-4e60-8fd6-0066d3b427df.md)          | `/base/v2/tweet-card/ba413be6-a840-4e60-8fd6-0066d3b427df/v1` | Slideshow |
| [Tweet Card with Photo/Video Background](/api/visuals/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66.md) | `/base/v2/tweet-card/9714ae5c-7e6b-4878-be4a-4b1ba5d0cd66/v1` | Slideshow |

***

## Tutorial Carousels

Step-by-step tutorial visuals with customizable styling.

| Template                                                                                             | ID                                                                   | Output    |
| ---------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | --------- |
| [Tutorial Carousel with Minimalist Flat Style](/api/visuals/2491f97b-1b47-4efa-8b96-8c651fa7b3d5.md) | `/base/v2/tutorial-carousel/2491f97b-1b47-4efa-8b96-8c651fa7b3d5/v1` | Slideshow |
| [Tutorial Carousel with Monocolor Background](/api/visuals/e095104b-e6c5-4a81-a89d-b0df3d7c5baf.md)  | `/base/v2/tutorial-carousel/e095104b-e6c5-4a81-a89d-b0df3d7c5baf/v1` | Slideshow |

***

## Images with Text

Combine images and text overlays in various styles.

| Template                                                                                            | ID                                                                  | Output    |
| --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- | --------- |
| [Image Slideshow with Prominent Text](/api/visuals/0ddb8655-c3da-43da-9f7d-be1915ca7818.md)         | `/base/v2/images-with-text/0ddb8655-c3da-43da-9f7d-be1915ca7818/v1` | Slideshow |
| [When X then Y Text Slideshow](/api/visuals/c9892c3b-fa75-4ade-821a-a50ff8456230.md)                | `/base/v2/images-with-text/c9892c3b-fa75-4ade-821a-a50ff8456230/v1` | Video     |
| [Video of Images and Text with Minimal Style](/api/visuals/3ed4bb92-dbfe-45e6-9dc8-605b77f70506.md) | `/base/v2/images-with-text/3ed4bb92-dbfe-45e6-9dc8-605b77f70506/v1` | Video     |

***

## Video Editor

Combine and edit video clips with titles, captions, and music.

| Template                                                                                    | ID                                                               | Output |
| ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ------ |
| [Combine Clips and Apply Basic Edits](/api/visuals/c306ae43-1dcc-4f45-ac2b-88e75430ffd8.md) | `/base/v2/combine-clips/c306ae43-1dcc-4f45-ac2b-88e75430ffd8/v1` | Video  |

***

## AI Videos

AI-powered video generation with voiceovers and narration.

| Template                                                                                                  | ID                                                                 | Output |
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ------ |
| [AI Video with AI Voice](/api/visuals/5903fe43-514d-40ee-a060-0d6628c5f8fd.md)                            | `/base/v2/ai-story-video/5903fe43-514d-40ee-a060-0d6628c5f8fd/v1`  | Video  |
| [AI Selfie Talking Video with Consistent Character](/api/visuals/57f5a565-fd17-458b-be43-4a2d8ccaca75.md) | `/base/v2/ai-selfie-video/57f5a565-fd17-458b-be43-4a2d8ccaca75/v1` | Video  |

***

## AI Avatar

AI avatar videos with generated B-roll footage.

| Template                                                                                   | ID                                                                 | Output |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ | ------ |
| [AI Avatar with AI Generated B-roll](/api/visuals/7c26a1cd-d5b3-42da-9c73-2413333873b3.md) | `/base/v2/ai-avatar-broll/7c26a1cd-d5b3-42da-9c73-2413333873b3/v1` | Video  |

***

## AI-Generated Infographics (V1 Legacy)

AI-powered infographic templates that generate single images based on text descriptions. Each template applies a unique visual style to your content.

### News and Media

| Template                                                                          | ID                                                     | Output |
| --------------------------------------------------------------------------------- | ------------------------------------------------------ | ------ |
| [TV Wall Infographic](/api/visuals/013904bf-6b3b-43f4-bb1f-f1964a38c29b.md)       | `/video-template/013904bf-6b3b-43f4-bb1f-f1964a38c29b` | Image  |
| [Newspaper Infographic](/api/visuals/07a5b5c5-387c-49e3-86b1-de822cd2dfc7.md)     | `/video-template/07a5b5c5-387c-49e3-86b1-de822cd2dfc7` | Image  |
| [Breaking News](/api/visuals/8800be71-52df-4ac7-ac94-df9d8a494d0f.md)             | `/video-template/8800be71-52df-4ac7-ac94-df9d8a494d0f` | Image  |
| [Movie Theater Infographic](/api/visuals/b88c8273-6406-48c6-85e7-096119aefe30.md) | `/video-template/b88c8273-6406-48c6-85e7-096119aefe30` | Image  |

### Urban and Street

| Template                                                                           | ID                                                     | Output |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------ | ------ |
| [Graffiti Mural Infographic](/api/visuals/3598483b-c148-4276-a800-eede85c1c62f.md) | `/video-template/3598483b-c148-4276-a800-eede85c1c62f` | Image  |
| [Bus Ad Infographic](/api/visuals/f9c0e470-9288-4958-8cdd-64772ed93c05.md)         | `/video-template/f9c0e470-9288-4958-8cdd-64772ed93c05` | Image  |
| [Billboard Infographic](/api/visuals/76b3b959-bdbe-440d-8428-984219353f18.md)      | `/video-template/76b3b959-bdbe-440d-8428-984219353f18` | Image  |

### Education

| Template                                                                                 | ID                                                     | Output |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------ |
| [Classroom Chalkboard Infographic](/api/visuals/d9495026-3945-44f6-8b44-07c28c492e6d.md) | `/video-template/d9495026-3945-44f6-8b44-07c28c492e6d` | Image  |
| [Whiteboard Infographic](/api/visuals/ae868019-820d-434c-8fe1-74c9da99129a.md)           | `/video-template/ae868019-820d-434c-8fe1-74c9da99129a` | Image  |
| [Chalkboard Infographic](/api/visuals/fcd64907-b103-46f8-9f75-51b9d1a522f5.md)           | `/video-template/fcd64907-b103-46f8-9f75-51b9d1a522f5` | Image  |

### Outdoor

| Template                                                                          | ID                                                     | Output |
| --------------------------------------------------------------------------------- | ------------------------------------------------------ | ------ |
| [Trail Marker Infographic](/api/visuals/29ebb2bd-02b7-4317-8bb8-c30eb938e47c.md)  | `/video-template/29ebb2bd-02b7-4317-8bb8-c30eb938e47c` | Image  |
| [Constellation Infographic](/api/visuals/5307053e-046b-4c9b-b1ca-38725d2ddcdd.md) | `/video-template/5307053e-046b-4c9b-b1ca-38725d2ddcdd` | Image  |

### Creative

| Template                                                                           | ID                                                     | Output    |
| ---------------------------------------------------------------------------------- | ------------------------------------------------------ | --------- |
| [Manga Panel Infographic](/api/visuals/49c61370-a706-4b82-98f7-62d557d1c66d.md)    | `/video-template/49c61370-a706-4b82-98f7-62d557d1c66d` | Image     |
| [T-Shirt Infographic](/api/visuals/476f8920-8749-4ff7-9c91-470d54c3c03e.md)        | `/video-template/476f8920-8749-4ff7-9c91-470d54c3c03e` | Image     |
| [Futuristic Flyer](/api/visuals/8fa8545e-8955-4a89-a868-cf45023d6cc5.md)           | `/video-template/8fa8545e-8955-4a89-a868-cf45023d6cc5` | Image     |
| [Book Page Infographic](/api/visuals/f8f1ebe4-a9f5-4ec8-be63-21214656cd4b.md)      | `/video-template/f8f1ebe4-a9f5-4ec8-be63-21214656cd4b` | Image     |
| [Single Centered Text Quote](/api/visuals/9f4e66cd-b784-4c02-b2ce-e6d0765fd4c0.md) | `/video-template/9f4e66cd-b784-4c02-b2ce-e6d0765fd4c0` | Slideshow |

### Tech

| Template                                                                       | ID                                                     | Output |
| ------------------------------------------------------------------------------ | ------------------------------------------------------ | ------ |
| [Steampunk Infographic](/api/visuals/7b7104f1-d277-4993-ad3a-e5883c4b776d.md)  | `/video-template/7b7104f1-d277-4993-ad3a-e5883c4b776d` | Image  |
| [Top Secret Infographic](/api/visuals/b8707b58-a106-44af-bb12-e30507e561af.md) | `/video-template/b8707b58-a106-44af-bb12-e30507e561af` | Image  |

### Historical

| Template                                                                                | ID                                                     | Output |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------ |
| [Egyptian Hieroglyph Infographic](/api/visuals/a7b0d128-8478-4b34-9647-a0778b6517d0.md) | `/video-template/a7b0d128-8478-4b34-9647-a0778b6517d0` | Image  |
| [Cave Painting Infographic](/api/visuals/82ee75b6-597b-43a8-86bc-e4395e7c9c44.md)       | `/video-template/82ee75b6-597b-43a8-86bc-e4395e7c9c44` | Image  |

***

## Don't See a Template for Your Use Case?

Submit a support ticket and describe the type of visual you need. To submit a ticket, click the orange circle button inside Blotato.

Include the following in your request:

* A description of the visual format you need (e.g., "listicle carousel with numbered items")
* The platform you plan to post on (e.g., Instagram, TikTok, LinkedIn)
* A link to an example of the format, if available

***

## See Also

* [Create Visual API Reference](/api/create-video.md)
* [Get Visual Status API Reference](/api/create-video/find-video.md)
* [Media Requirements](https://github.com/Blotato-Inc/help.blotato.com/blob/main/api/media.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blotato.com/api/visuals.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
