# Endpoints

## Generate Ads

 - [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 with our public templates and brands.
For creating your own private templates and brands, please Contact Us.
Getting Started with Public Assets
You can start exploring the API immediately using our public templates and brands, with no setup required. You can also explore them in our Playground Demo.
* 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.

    


Template  
Templates enable to repurpose and reuse well-design ads that share the same style, content and branded elements.It consists of multiple ads (“scenes”) and includes configurations for customizing the content at scale.

Smart Image Feature  
A standout feature of BRIA's Ads Generation API is its ability to seamlessly embed objects, products, and presenter images into another image (a "smart image"). This AI-powered capability allows for generating diverse backgrounds for the embedded image or extending the background to fit the ad's design perfectly.

How It Works  
The Ads Generation API works by sending a template ID along with inputs such as text, images, the main object with its background definition, and a brand ID (including logos, colors, and fonts). In response, the API generates a set of ad images.

In thie endpoint, responses are asynchronous, immediately providing URLs for ads that are generated in the background. Use polling for the URLs to retrieve ads once ready.

Templates can be easily created using BRIA’s Ads Editor. Once a template is ready, it can be used to produce multiple ad versions with varying messaging, branding, and images.

This API endpoint supports content moderation via an optional parameter that can prevent generation if input images contain inappropriate content, and filters out unsafe generated images - the first blocked input image will fail the entire request.

## Get Brands

 - [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 list, please Contact Us.

## Get Templates

 - [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. You can see these in action in our Playground Demo. To create your own private templates that will appear here, please Contact Us.

## Get Template info by ID

 - [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.