Bannerbear API
★ Only Publicly Available OpenAPI DocumentMediaImage Processingbearer55 EndpointsREST
For Agents
Generate branded images, videos, animated GIFs, and URL screenshots on demand from Bannerbear templates. Suited to agents producing dynamic marketing creatives and personalised assets at scale.
Use for: Generate a personalised social media image for a new product launch, Render a video from a Bannerbear template with custom captions, Create an animated GIF advert with rotating headlines, Take a screenshot of a landing page URL at desktop resolution
Not supported: Does not handle template design editing, asset storage as a CDN, or live video streaming — use for rendering images, videos, GIFs, and screenshots from prebuilt templates only.
Jentic publishes the only available OpenAPI specification for the Bannerbear API, keeping it validated and agent-ready. Bannerbear automates image and video generation from designer-built templates, exposing endpoints for one-off images, batched collections, animated GIFs, screenshots of URLs, and rendered videos. Each render request supplies modifications (text, image swaps, colour overrides) to a template, and Bannerbear returns hosted output assets ready to embed in social posts, landing pages, or email. The API is widely used for personalised marketing creatives and dynamic OG images.
Install Jentic One Beta
Connect the Bannerbear API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bannerbear API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Bannerbear API.
Render images from a Bannerbear template with text and image modifications
Generate batches of images as a collection in a single request
Create animated GIFs by interpolating layer modifications across frames
Capture full-page screenshots of URLs at configurable resolutions
Render videos by composing template frames with audio and timing controls
Inspect templates, collections, and projects to drive automated pipelines
Use Cases
Patterns agents use Bannerbear API for, with concrete tasks.
★ Personalised Marketing Creatives at Scale
Generate thousands of personalised images for email, social, and ad campaigns by feeding customer data into Bannerbear templates. Marketing teams design templates once in Bannerbear's editor and then drive variations through POST /v2/images, swapping recipient names, product photos, and colour themes. This replaces handcrafted Photoshop work and cuts campaign turnaround from days to minutes.
POST /v2/images with template UID 'tpl_abc' and modifications mapping the customer's name, product image URL, and brand colour, then return the image_url from the response.
Dynamic Open Graph and Social Cards
Generate per-page Open Graph images for blog posts, product pages, and shareable links using Bannerbear templates. Drop a request to POST /v2/images at publish time or render on demand from a serverless function for share-time previews. Pair with /v2/screenshots when an actual rendered page snapshot is preferable to a templated card.
POST /v2/images for blog post 'how-to-rank-on-google' with the post title and author headshot, then store the returned image_url on the post record for OG meta tags.
Short-Form Video and Animated Ad Production
Produce short-form videos and animated GIFs at scale by sending modifications to /v2/videos and /v2/animated_gifs. Bannerbear handles transcoding, frame composition, and audio overlay, so marketing teams iterate on creative variants without owning a video pipeline. Useful for social ads, product highlight reels, and animated email banners.
POST /v2/videos with template UID 'vid_promo' and modifications for product name, price, and a stock background, then poll GET /v2/videos/{uid} until status is completed.
AI Agent Creative Producer via Jentic
Wire an AI agent to Bannerbear through Jentic so it can act as an on-demand creative producer. The agent searches Jentic for an intent like 'generate a marketing image', loads the Bannerbear schema, and executes the call with the API key held in the Jentic vault. The agent can compose copy, choose templates, and return finished image URLs to a chat UI or email draft.
Search Jentic for 'create a marketing image', execute POST /v2/images against template 'tpl_promo' with copy generated by the agent, and post the rendered image_url to Slack.
Key Endpoints
55 endpoints — jentic publishes the only available openapi specification for the bannerbear api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/v2/images
Render an image from a template
GET
/v2/images/{uid}
Get a rendered image and its status
POST
/v2/videos
Render a video from a template
GET
/v2/videos/{uid}
Get a rendered video and its status
POST
/v2/animated_gifs
Render an animated GIF
POST
/v2/screenshots
Capture a screenshot of a URL
POST
/v2/collections
Create a batched collection of image renders
POST
/v2/images
Render an image from a template
GET
/v2/images/{uid}
Get a rendered image and its status
POST
/v2/videos
Render a video from a template
GET
/v2/videos/{uid}
Get a rendered video and its status
POST
/v2/animated_gifs
Render an animated GIF
POST
/v2/screenshots
Capture a screenshot of a URL
POST
/v2/collections
Create a batched collection of image renders
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Bannerbear bearer API keys are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped execution access and the raw key never appears in the LLM context window or logs.
Intent-based discovery
Agents search by intent (for example, 'create a marketing image' or 'render a short video') and Jentic returns the matching Bannerbear operations with their input schemas and required template parameters.
Time to first call
Direct Bannerbear integration: 1-2 days for auth, render polling, and asset storage. Through Jentic: under 30 minutes — search, load schema, execute, and handle the returned asset URL.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Bannerbear API through Jentic.
Why is there no official OpenAPI spec for Bannerbear?
Bannerbear does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Bannerbear via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Bannerbear API use?
Bannerbear uses HTTP bearer authentication with a project-scoped API key passed in the Authorization header. When called through Jentic, the key is stored encrypted in the Jentic vault and injected at request time so it never enters the agent's context.
Can I generate videos with the Bannerbear API?
Yes. POST /v2/videos with a video template UID and modifications, then poll GET /v2/videos/{uid} until the status is completed. The response includes the hosted MP4 URL ready to embed or download.
What are the rate limits for the Bannerbear API?
Bannerbear enforces rate limits per project plan rather than a single global value. Image renders are typically the most permissive; video and screenshot endpoints have lower concurrent-render limits. Inspect the response headers for current quota and back off when retries are signalled.
How do I render an image through Jentic?
Install the Jentic SDK with pip install jentic, search for 'create a marketing image', and execute the matched POST /v2/images operation with the template UID and modifications. Jentic injects the bearer token, calls Bannerbear, and returns the image_url to the agent.
Does Bannerbear support URL screenshots?
Yes. POST /v2/screenshots with a target URL and viewport options to render a full-page screenshot. Then call GET /v2/screenshots/{uid} to retrieve the hosted image URL once the render completes.
GET STARTED