# Ads Generation API Reference

Bria's Ads Generation API enables builders to create multiple ads (scenes) in various sizes and resolutions, all unified by the same branding, style, and messaging. You can start exploring immediately with our public templates and brands.

For creating your own private templates and brands, please [Contact Us](https://bria.ai/contact-us).

**Getting Started with Public Assets**

You can start exploring the API immediately using our public templates and brands, with no setup required.

* **Public Template IDs**: 
    * **`1062`**: A template that requires a brand ID.
    * **`1061`**: A brand-independent template (does not require a brand ID).
* **Public Brand IDs**: **`167`**, **`166`**, **`122`**, **`121`**, **`120`**. These can be used for testing with compatible templates like **`1062`**.
* **Important**: Public templates and brands can only be used with each other and cannot be mixed with private assets.

The Ads Generation API provides a set of endpoints to manage the assets needed for ads generation:

1. **Templates**: Pre-designed ad layouts that can be reused and customized:
    - Access template libraries and their configurations 
    - Each template contains multiple scenes with customizable elements
    - Templates can be created using BRIA's Ads Editor

2. **Brands**: Define and manage brand assets:
    - Store and retrieve brand-specific elements like logos, colors, and fonts
    - Ensure brand consistency across all generated ads

3. **Ads Generation**: Create ads using templates and brand assets:
    - Customize text, images, and smart image backgrounds
    - Generate multiple ad variations at scale
    - Configure scene-specific elements and properties



## Servers

```
https://engine.prod.bria-api.com/v1
```

## Download OpenAPI description

 - [Ads Generation API Reference](https://docs.bria.ai/_bundle/ad-generation.yaml)

## Endpoints

 - [POST /ads/generate](https://docs.bria.ai/ad-generation/endpoints/generate-ads.md): Bria's Ads Generation API enables builders to create multiple ads (scenes) in various sizes and resolutions, all unified by the same branding, style, and messaging. You can start exploring immediately
 - [GET /ads/brands](https://docs.bria.ai/ad-generation/endpoints/get-brands.md): Retrieves the list of your private brands. For initial testing, you can use our public brand IDs directly in the `/ads/generate` endpoint. To create your own private brands that will appear in this li
 - [GET /ads/templates](https://docs.bria.ai/ad-generation/endpoints/get-templates.md): Retrieves the list of your private templates. To start experimenting right away, use our public template IDs (**1062**, **1061**) directly in the `/ads/generate` endpoint. To create your own private t
 - [GET /ads/templates/{template_id}](https://docs.bria.ai/ad-generation/endpoints/paths/~1ads~1templates~1%7Btemplate_id%7D/get.md): Retrieve details for a specific private template by its ID. Please note: This endpoint is for inspecting your private templates only and cannot be used to retrieve details for public template IDs.