> For the complete documentation index, see [llms.txt](https://help.blotato.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.blotato.com/rest-api-reference/visuals/c9892c3b-fa75-4ade-821a-a50ff8456230.md).

# When X then Y Text Slideshow

Show examples of "When X happens, then Y happens" scenarios with AI-generated images. 2.7M views, 2,700 likes.

## When to Use This Template

* You are creating comparison or "what they say vs. what you should say" content
* Popular format for business tips, negotiation advice, mindset shifts, and before/after scenarios
* You want a structured side-by-side comparison layout with AI-generated images
* Works for coaches, consultants, and educators on TikTok, Instagram, and LinkedIn

## Template Information

| Property    | Value                                                               |
| ----------- | ------------------------------------------------------------------- |
| Template ID | `/base/v2/images-with-text/c9892c3b-fa75-4ade-821a-a50ff8456230/v1` |
| Output Type | Video                                                               |
| Category    | Images with Text                                                    |

## Parameters

| Parameter                             | Type   | Required | Default | Description                                  |
| ------------------------------------- | ------ | -------- | ------- | -------------------------------------------- |
| firstSlideText                        | string | Yes      | -       | Hook text for first slide. 30-70 chars       |
| firstSlideImagePrompt                 | string | Yes      | -       | AI prompt for first slide image. 1-400 chars |
| comparisonTextTop                     | string | Yes      | -       | Top comparison label. 1-50 chars             |
| comparisonTextBottom                  | string | Yes      | -       | Bottom comparison label. 1-50 chars          |
| lastSlideText                         | string | Yes      | -       | Text for last slide. 1-350 chars             |
| lastSlideImagePrompt                  | string | Yes      | -       | AI prompt for last slide image. 1-400 chars  |
| slides                                | array  | Yes      | -       | Comparison slides. Min: 1, Max: 20           |
| slides\[].topComparisonExampleText    | string | Yes      | -       | Top example. 20-200 chars                    |
| slides\[].bottomComparisonExampleText | string | Yes      | -       | Bottom example. 20-200 chars                 |
| slideDuration                         | number | No       | 5       | Seconds per slide. Range: 1-10               |
| aspectRatio                           | enum   | No       | 4:5     | Values: 16:9, 1:1, 4:5, 9:16                 |

## Example 1: AI-Powered with Prompt

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

{
  "templateId": "/base/v2/images-with-text/c9892c3b-fa75-4ade-821a-a50ff8456230/v1",
  "inputs": {},
  "prompt": "Create a video about negotiation phrases every founder should know, comparing what clients say vs how you should respond",
  "render": true
}
```

## Example 2: Manual Inputs

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

{
  "templateId": "/base/v2/images-with-text/c9892c3b-fa75-4ade-821a-a50ff8456230/v1",
  "inputs": {
    "firstSlideText": "Negotiation phrases every founder should know",
    "firstSlideImagePrompt": "Professional business meeting with two people shaking hands",
    "comparisonTextTop": "When they say:",
    "comparisonTextBottom": "You say:",
    "slides": [
      {
        "topComparisonExampleText": "Your pricing does not fit our budget right now",
        "bottomComparisonExampleText": "Help me understand what you are working with."
      },
      {
        "topComparisonExampleText": "We need to think about it",
        "bottomComparisonExampleText": "What specific concerns do you want to address?"
      },
      {
        "topComparisonExampleText": "Your competitor is cheaper",
        "bottomComparisonExampleText": "What would make the extra investment worthwhile for you?"
      }
    ],
    "lastSlideText": "Follow for more business tips",
    "lastSlideImagePrompt": "Successful entrepreneur celebrating a closed deal",
    "slideDuration": 5,
    "aspectRatio": "4:5"
  },
  "render": true
}
```

## Example 3: Hybrid Approach

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

{
  "templateId": "/base/v2/images-with-text/c9892c3b-fa75-4ade-821a-a50ff8456230/v1",
  "inputs": {
    "comparisonTextTop": "What beginners think:",
    "comparisonTextBottom": "What experts know:",
    "aspectRatio": "9:16"
  },
  "prompt": "Create a video comparing beginner vs expert mindsets in investing with 4 examples",
  "render": true
}
```

## Related Templates

* [Image Slideshow with Prominent Text](/rest-api-reference/visuals/0ddb8655-c3da-43da-9f7d-be1915ca7818.md)
* [Video of Images and Text with Minimal Style](/rest-api-reference/visuals/3ed4bb92-dbfe-45e6-9dc8-605b77f70506.md)

## See Also

* [Create Visual API Reference](/rest-api-reference/create-video.md)
* [All Visual Templates](/rest-api-reference/visuals.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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.blotato.com/rest-api-reference/visuals/c9892c3b-fa75-4ade-821a-a50ff8456230.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
