> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/api/visual-templates-1.md).

# Visual Templates

> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/api/visuals.md).

## Visual Templates

Create images and videos using pre-built templates with the Create Visual API endpoint.

### 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.contouron.com/v2/videos/from-templates
Content-Type: application/json
contouron-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 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 | `/base/v2/image-slideshow/5903b592-1255-43b4-b9ac-f8ed7cbf6a5f/v1` | Slideshow |
| Instagram Carousel Slideshow       | `53cfec04-2500-41cf-8cc1-ba670d2c341a`                             | Slideshow |

***

### Quote Cards

Quote card carousels with various background styles.

| Template                                       | ID                                                            | Output    |
| ---------------------------------------------- | ------------------------------------------------------------- | --------- |
| Quote Card with Monocolor Background           | `/base/v2/quote-card/77f65d2b-48cc-4adb-bfbb-5bc86f8c01bd/v1` | Slideshow |
| Quote Card with Paper Background and Highlight | `/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          | `/base/v2/tweet-card/ba413be6-a840-4e60-8fd6-0066d3b427df/v1` | Slideshow |
| Tweet Card with Photo/Video Background | `/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 | `/base/v2/tutorial-carousel/2491f97b-1b47-4efa-8b96-8c651fa7b3d5/v1` | Slideshow |
| Tutorial Carousel with Monocolor Background  | `/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         | `/base/v2/images-with-text/0ddb8655-c3da-43da-9f7d-be1915ca7818/v1` | Slideshow |
| When X then Y Text Slideshow                | `/base/v2/images-with-text/c9892c3b-fa75-4ade-821a-a50ff8456230/v1` | Video     |
| Video of Images and Text with Minimal Style | `/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 | `/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                            | `/base/v2/ai-story-video/5903fe43-514d-40ee-a060-0d6628c5f8fd/v1`  | Video  |
| AI Selfie Talking Video with Consistent Character | `/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 | `/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       | `/video-template/013904bf-6b3b-43f4-bb1f-f1964a38c29b` | Image  |
| Newspaper Infographic     | `/video-template/07a5b5c5-387c-49e3-86b1-de822cd2dfc7` | Image  |
| Breaking News             | `/video-template/8800be71-52df-4ac7-ac94-df9d8a494d0f` | Image  |
| Movie Theater Infographic | `/video-template/b88c8273-6406-48c6-85e7-096119aefe30` | Image  |

#### Urban and Street

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

#### Education

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

#### Outdoor

| Template                  | ID                                                     | Output |
| ------------------------- | ------------------------------------------------------ | ------ |
| Trail Marker Infographic  | `/video-template/29ebb2bd-02b7-4317-8bb8-c30eb938e47c` | Image  |
| Constellation Infographic | `/video-template/5307053e-046b-4c9b-b1ca-38725d2ddcdd` | Image  |

#### Creative

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

#### Tech

| Template               | ID                                                     | Output |
| ---------------------- | ------------------------------------------------------ | ------ |
| Steampunk Infographic  | `/video-template/7b7104f1-d277-4993-ad3a-e5883c4b776d` | Image  |
| Top Secret Infographic | `/video-template/b8707b58-a106-44af-bb12-e30507e561af` | Image  |

#### Historical

| Template                        | ID                                                     | Output |
| ------------------------------- | ------------------------------------------------------ | ------ |
| Egyptian Hieroglyph Infographic | `/video-template/a7b0d128-8478-4b34-9647-a0778b6517d0` | Image  |
| Cave Painting Infographic       | `/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 Contouron.

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
* Get Visual Status API Reference
* [Media Requirements](https://github.com/Contouron-Inc/help.contouron.com/blob/main/api/media.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.contouron.com/api/visual-templates-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.