LovPics AI Banners API
The ai-banners API from LovPics — 7 operation(s) for ai-banners.
The ai-banners API from LovPics — 7 operation(s) for ai-banners.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/lovpics-com:lovpics-com-ai-banners-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Virtual Studio AI Banners API
version: 0.1.0
tags:
- name: ai-banners
paths:
/api/ai-banners/generate:
post:
tags:
- ai-banners
summary: Generate Banner
operationId: generate_banner_api_ai_banners_generate_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateBannerRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateBannerResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/ai-banners/localize:
post:
tags:
- ai-banners
summary: Localize Banner
description: 'Localize (translate text in) a banner image to the given language.
Same flow as generate: check credits, generate image, deduct credits, store in GCS, save creative.'
operationId: localize_banner_api_ai_banners_localize_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/LocalizeBannerRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateBannerResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/ai-banners/create-brochure:
post:
tags:
- ai-banners
summary: Create Brochure
description: 'Create a PDF brochure from selected banners.
Args:
request: CreateBrochureRequest with list of banner URLs
Returns:
CreateBrochureResponse with generated brochure URL'
operationId: create_brochure_api_ai_banners_create_brochure_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBrochureRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBrochureResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/ai-banners/banners:
get:
tags:
- ai-banners
summary: Get User Banners
description: 'Get all banners for the current user.
Args:
current_user: Authenticated user information
Returns:
List of user''s banners with metadata'
operationId: get_user_banners_api_ai_banners_banners_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/BannerListResponse'
security:
- HTTPBearer: []
/api/ai-banners/intelligence/generate:
post:
tags:
- ai-banners
summary: Generate Intelligence Banner
description: 'Multi-agent intelligence pipeline: analyze product → strategic concepts → generate banner.'
operationId: generate_intelligence_banner_api_ai_banners_intelligence_generate_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IntelligenceBannerRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/IntelligenceBannerResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/ai-banners/intelligence/generate-stream:
post:
tags:
- ai-banners
summary: Generate Intelligence Banner Stream
description: Stream progress events while running the intelligence banner pipeline.
operationId: generate_intelligence_banner_stream_api_ai_banners_intelligence_generate_stream_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/IntelligenceBannerRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/ai-banners/health:
get:
tags:
- ai-banners
summary: Health Check
description: Health check endpoint for AI Banners service.
operationId: health_check_api_ai_banners_health_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
components:
schemas:
IntelligenceBannerRequest:
properties:
productImage:
anyOf:
- type: string
- type: 'null'
title: Productimage
companyLogo:
anyOf:
- type: string
- type: 'null'
title: Companylogo
details:
anyOf:
- type: string
- type: 'null'
title: Details
default: ''
aspectRatio:
type: string
title: Aspectratio
default: '16:9'
type: object
title: IntelligenceBannerRequest
GenerateBannerResponse:
properties:
success:
type: boolean
title: Success
bannerUrl:
type: string
title: Bannerurl
message:
type: string
title: Message
creative_id:
anyOf:
- type: integer
- type: 'null'
title: Creative Id
type: object
required:
- success
- bannerUrl
- message
title: GenerateBannerResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CreateBrochureRequest:
properties:
bannerUrls:
items:
type: string
type: array
title: Bannerurls
aspectRatio:
type: string
title: Aspectratio
type: object
required:
- bannerUrls
- aspectRatio
title: CreateBrochureRequest
LocalizeBannerRequest:
properties:
imageUrl:
type: string
title: Imageurl
language:
type: string
title: Language
aspectRatio:
type: string
title: Aspectratio
default: '16:9'
type: object
required:
- imageUrl
- language
title: LocalizeBannerRequest
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
BannerListResponse:
properties:
success:
type: boolean
title: Success
examples:
- true
banners:
items:
additionalProperties: true
type: object
type: array
title: Banners
message:
anyOf:
- type: string
- type: 'null'
title: Message
examples:
- Banners retrieved successfully
additionalProperties: true
type: object
required:
- success
- banners
title: BannerListResponse
CreateBrochureResponse:
properties:
success:
type: boolean
title: Success
brochureUrl:
type: string
title: Brochureurl
message:
type: string
title: Message
type: object
required:
- success
- brochureUrl
- message
title: CreateBrochureResponse
GenerateBannerRequest:
properties:
images:
items:
type: string
type: array
title: Images
default: []
companyLogo:
anyOf:
- type: string
- type: 'null'
title: Companylogo
referenceImage:
anyOf:
- type: string
- type: 'null'
title: Referenceimage
title:
type: string
title: Title
description:
type: string
title: Description
default: ''
mobileNo:
type: string
title: Mobileno
default: ''
email:
anyOf:
- type: string
- type: 'null'
title: Email
default: ''
bannerPurpose:
type: string
title: Bannerpurpose
address:
type: string
title: Address
default: ''
ctaButtonText:
type: string
title: Ctabuttontext
default: ''
instructions:
type: string
title: Instructions
default: ''
aspectRatio:
type: string
title: Aspectratio
default: '16:9'
bannerStyle:
type: string
title: Bannerstyle
default: modern
backgrounds:
type: string
title: Backgrounds
default: ''
brand:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Brand
previous_generations:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Previous Generations
modelType:
anyOf:
- type: string
- type: 'null'
title: Modeltype
default: pro
imageOutputSize:
anyOf:
- type: string
- type: 'null'
title: Imageoutputsize
default: 1K
type: object
required:
- title
- bannerPurpose
title: GenerateBannerRequest
IntelligenceBannerResponse:
properties:
success:
type: boolean
title: Success
bannerUrl:
type: string
title: Bannerurl
message:
type: string
title: Message
creative_id:
anyOf:
- type: integer
- type: 'null'
title: Creative Id
intelligence:
additionalProperties: true
type: object
title: Intelligence
default: {}
strategic_concepts:
items:
additionalProperties: true
type: object
type: array
title: Strategic Concepts
default: []
selected_concept:
additionalProperties: true
type: object
title: Selected Concept
default: {}
concept_scores:
items:
additionalProperties: true
type: object
type: array
title: Concept Scores
default: []
banner_scores:
additionalProperties: true
type: object
title: Banner Scores
default: {}
type: object
required:
- success
- bannerUrl
- message
title: IntelligenceBannerResponse
securitySchemes:
HTTPBearer:
type: http
scheme: bearer