Bria8f2b Campaign Generation (Coming soon) API
The Campaign Generation (Coming soon) API from Bria8f2b — 4 operation(s) for campaign generation (coming soon).
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/bria8f2b-campaign-generation-coming-soon-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Bria Campaign Generation (Coming soon) API
version: ''
contact:
name: We are happy to answer any questions you may have at
email: support@bria.ai
description: '# Introduction
The Bria API is designed to provide a comprehensive suite of tools for generating and customizing images.'
servers:
- url: https://engine.prod.bria-api.com/v1
tags:
- name: Campaign Generation (Coming soon)
paths:
/campaign_api/generate:
post:
tags:
- Campaign Generation (Coming soon)
summary: Generate a Campaign
description: 'The Campaign Generation API enables the creation of multiple ads (scenes) in various sizes and resolutions, all unified by the same branding, style, and messaging. This is essential for testing different ad variations, repurposing successful ad formats, and significantly reducing the manual effort required to create multiple ads.
BRIA''s Campaign Generation API provides a unique and scalable solution for producing professional-grade ads while minimizing the need for time-consuming design work.
**Smart Image Feature**
A standout feature of BRIA''s Campaign 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 Campaign 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.
Templates can be easily created using BRIA’s Campaign Editor application. Once a template is ready, it can be used to produce multiple ad versions with varying messaging, branding, and images.'
operationId: generateCampaign
parameters:
- in: header
name: api_token
schema:
type: string
required: true
description: API token associated with the organization.
requestBody:
content:
application/json:
schema:
type: object
properties:
template_id:
type: string
description: The ID of the template to be used for generating the campaign scenes.
brand_id:
type: string
description: The ID of the brand.
canvas_color:
default: '#FFFFFF'
type: string
description: Canvas background color in hex format.
smart_image:
type: object
description: 'Smart image object for generating an image based on the embedded image, including the main object and its background definition (`expand` or `generate_by_text`).
'
properties:
main_object_url:
type: string
description: URL of the main image that will be embedded within the smart image.
background:
description: 'Background object to determine the operation type and its associated input.
'
type: object
properties:
operation:
type: string
description: 'Choose whether to expand the existing image background or replace it by generating a new one.
'
enum:
- expand
- generate_by_text
input:
type: string
description: Background prompt or hex color for the image’s background.
required:
- main_object_url
elements:
type: array
description: List of text/images objects
items:
type: object
properties:
layer_type:
type: string
description: The element type, either "text" or "image".
enum:
- text
- image
content_type:
type: string
description: 'The heading level configuration for the text. This allows the same text to be inserted into multiple elements across scenes.
Value should be in the format - `Heading *`, `Body *`, `Image *` when * can be replaced with any number between 1-5.
'
content:
type: string
description: 'Content of the text or image, if `content_type` is set to `text` it should be a string, and if `content_type` is `image` it should be an image URL.
To ignore this element, set this parameter to an empty string.
'
id:
type: string
description: Unique identifier for the element.
text_configs:
type: object
description: 'Text configs object to set text configuration to be applied to the text element
'
properties:
highlight_color:
type: string
description: Color to highlight the text.
strikethrough:
type: boolean
description: Strike through the text.
shadow:
type: object
properties:
blur:
type: integer
description: Blur amount for the text shadow.
color:
type: string
description: Color of the text shadow.
offset:
type: object
properties:
x:
type: number
format: int
description: Shadow's x-axis offset.
y:
type: number
format: int
description: Shadow's y-axis offset.
fix_text_box:
type: object
description: The “Fix text box” object allows you to specify the text box dimensions and the max font size and it will resize the content text within the text box.
properties:
width:
type: number
format: float
description: The width of the text box in pixels
height:
type: number
format: float
description: The height of the text box in pixels
max_font_size:
type: number
format: int
description: The maximum font size to ensure that, during rescaling, the font size does not exceed this value.
example:
template_id: '123'
smart_image:
main_object_url: https://example.com/image.jpg
background:
operation: generate_by_text
input: A scenic background
brand_id: '456'
background_color: '#FFFFFF'
elements:
- layer_type: text
content_type: Heading 1
content: Sale Now!
text_configs:
highlight_color: '#FF5733'
strikethrough: false
shadow:
blur: 10
color: '#000000'
offset:
x: 2
y: 2
responses:
'200':
description: Campaign generated successfully.
content:
application/json:
schema:
type: array
items:
type: string
description: URL of the generated campaign ad.
'400':
description: Bad request.
'401':
description: Unauthorized. Invalid API key or authentication token.
'422':
description: Value error in the request body.
'500':
description: Internal server error.
/campaign_api/brands:
get:
tags:
- Campaign Generation (Coming soon)
summary: Get Brands
description: Get a list of brands that can be used to customize your campaign with the brand's colors, fonts, and logos. Brands are created in BRIA’s Campaign Editor application by the organization's Admins.
operationId: getBrands
parameters:
- in: header
name: api_token
schema:
type: string
required: true
description: API token associated with the organization.
responses:
'200':
description: The list of brands, where each brand is an object containing the following properties - ID, name, description, and creation date.
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
description:
type: string
created_at:
type: string
'401':
description: Unauthorized. Invalid API key or authentication token.
/campaign_api/templates:
get:
tags:
- Campaign Generation (Coming soon)
summary: Get List of Templates
description: Retrieve a list of templates available for campaign generation.
operationId: getTemplates
parameters:
- in: header
name: api_token
schema:
type: string
required: true
description: API token associated with the organization.
responses:
'200':
description: The list of templates, where each template is an object containing the following properties - ID, name, description, creation date, number of scenes and a preview.
content:
application/json:
schema:
type: array
items:
type: object
properties:
id:
type: integer
name:
type: string
description:
type: string
created_at:
type: string
number_of_scenes:
type: integer
preview:
type: string
'401':
description: Unauthorized. Invalid API key or authentication token.
/campaign_api/templates/{template_id}:
get:
tags:
- Campaign Generation (Coming soon)
summary: Get Template Information
description: Retrieve details for a specific template by template ID.
operationId: getTemplateInfo
parameters:
- in: header
name: api_token
schema:
type: string
required: true
description: API token associated with the organization.
- in: path
name: template_id
schema:
type: string
required: true
description: The ID of the template.
responses:
'200':
description: The requested template ID object, containing its ID, scene number, and the elements object.
content:
application/json:
schema:
type: object
properties:
id:
type: string
scene_number:
type: integer
elements:
type: array
items:
type: object
properties:
layer_type:
type: string
content_type:
type: string
content:
type: string
'401':
description: Unauthorized. Invalid API key or authentication token.
'404':
description: Template not found for the provided template ID.
externalDocs:
description: Register and get API Access
url: https://labs.bria.ai/api-plans