LovPics AI Campaigns API
The ai-campaigns API from LovPics — 4 operation(s) for ai-campaigns.
The ai-campaigns API from LovPics — 4 operation(s) for ai-campaigns.
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-campaigns-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 Campaigns API
version: 0.1.0
tags:
- name: ai-campaigns
paths:
/api/ai-campaigns/plan:
post:
tags:
- ai-campaigns
summary: 'Plan an ad campaign: returns creative concepts/headlines to feed into…'
description: Analyse the company website and return the per-image campaign content plan.
operationId: plan_campaign_api_ai_campaigns_plan_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PlanCampaignRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/PlanCampaignResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/ai-campaigns/generate-image:
post:
tags:
- ai-campaigns
summary: Generate one ad campaign creative image from a planned concept; returns image…
description: Generate one campaign creative image; deducts 4/6/8 credits for 1K/2K/4K.
operationId: generate_campaign_image_api_ai_campaigns_generate_image_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateCampaignImageRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateCampaignImageResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
/api/ai-campaigns/creatives:
get:
tags:
- ai-campaigns
summary: Get Campaign Creatives
description: List the user's AI Campaign creatives (crt_type = 21).
operationId: get_campaign_creatives_api_ai_campaigns_creatives_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/GetCampaignCreativesResponse'
security:
- HTTPBearer: []
/api/ai-campaigns/health:
get:
tags:
- ai-campaigns
summary: Health Check
operationId: health_check_api_ai_campaigns_health_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
components:
schemas:
CampaignPlanItem:
properties:
on_image_headline:
type: string
title: On Image Headline
default: ''
on_image_subline:
type: string
title: On Image Subline
default: ''
title:
type: string
title: Title
description:
type: string
title: Description
image_concept:
type: string
title: Image Concept
type: object
required:
- title
- description
- image_concept
title: CampaignPlanItem
PlanCampaignResponse:
properties:
success:
type: boolean
title: Success
brand_name:
type: string
title: Brand Name
brand_summary:
type: string
title: Brand Summary
campaign_thread:
type: string
title: Campaign Thread
default: ''
hero_subject:
type: string
title: Hero Subject
default: ''
hero_product_or_focus:
type: string
title: Hero Product Or Focus
default: ''
visual_style_lock:
type: string
title: Visual Style Lock
default: ''
typography_style:
type: string
title: Typography Style
default: ''
creative_type:
type: string
title: Creative Type
items:
items:
$ref: '#/components/schemas/CampaignPlanItem'
type: array
title: Items
message:
type: string
title: Message
default: ''
type: object
required:
- success
- brand_name
- brand_summary
- creative_type
- items
title: PlanCampaignResponse
PlanCampaignRequest:
properties:
companyWebsite:
type: string
title: Companywebsite
creativeType:
type: string
title: Creativetype
default: feature_focused
numberOfImages:
type: integer
title: Numberofimages
default: 1
instructions:
type: string
title: Instructions
default: ''
companyLogo:
anyOf:
- type: string
- type: 'null'
title: Companylogo
withModel:
type: boolean
title: Withmodel
default: false
modelImage:
anyOf:
- type: string
- type: 'null'
title: Modelimage
modelDescription:
anyOf:
- type: string
- type: 'null'
title: Modeldescription
type: object
required:
- companyWebsite
title: PlanCampaignRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
GenerateCampaignImageResponse:
properties:
success:
type: boolean
title: Success
imageUrl:
type: string
title: Imageurl
title:
type: string
title: Title
description:
type: string
title: Description
creative_id:
anyOf:
- type: integer
- type: 'null'
title: Creative Id
credits_used:
type: integer
title: Credits Used
default: 0
message:
type: string
title: Message
default: ''
type: object
required:
- success
- imageUrl
- title
- description
title: GenerateCampaignImageResponse
CampaignCreative:
properties:
id:
type: string
title: Id
title:
type: string
title: Title
description:
type: string
title: Description
imageUrl:
type: string
title: Imageurl
drivePath:
anyOf:
- type: string
- type: 'null'
title: Drivepath
aspectRatio:
type: string
title: Aspectratio
createdAt:
type: string
title: Createdat
creditsUsed:
type: integer
title: Creditsused
type: object
required:
- id
- title
- description
- imageUrl
- aspectRatio
- createdAt
- creditsUsed
title: CampaignCreative
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
GenerateCampaignImageRequest:
properties:
companyWebsite:
type: string
title: Companywebsite
brandName:
type: string
title: Brandname
default: ''
brandSummary:
type: string
title: Brandsummary
default: ''
creativeType:
type: string
title: Creativetype
default: feature_focused
title:
type: string
title: Title
description:
type: string
title: Description
default: ''
imageConcept:
type: string
title: Imageconcept
default: ''
onImageHeadline:
type: string
title: Onimageheadline
default: ''
onImageSubline:
type: string
title: Onimagesubline
default: ''
aspectRatio:
type: string
title: Aspectratio
default: '1:1'
imageOutputSize:
type: string
title: Imageoutputsize
default: 1K
companyLogo:
anyOf:
- type: string
- type: 'null'
title: Companylogo
referenceImages:
items:
type: string
type: array
title: Referenceimages
default: []
modelImage:
anyOf:
- type: string
- type: 'null'
title: Modelimage
modelDescription:
anyOf:
- type: string
- type: 'null'
title: Modeldescription
campaignThread:
type: string
title: Campaignthread
default: ''
heroSubject:
type: string
title: Herosubject
default: ''
heroProductOrFocus:
type: string
title: Heroproductorfocus
default: ''
visualStyleLock:
type: string
title: Visualstylelock
default: ''
typographyStyle:
type: string
title: Typographystyle
default: ''
imageIndex:
type: integer
title: Imageindex
default: 1
totalImages:
type: integer
title: Totalimages
default: 1
type: object
required:
- companyWebsite
- title
title: GenerateCampaignImageRequest
GetCampaignCreativesResponse:
properties:
success:
type: boolean
title: Success
creatives:
items:
$ref: '#/components/schemas/CampaignCreative'
type: array
title: Creatives
message:
type: string
title: Message
default: ''
type: object
required:
- success
- creatives
title: GetCampaignCreativesResponse
securitySchemes:
HTTPBearer:
type: http
scheme: bearer