Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Captions AI Ads API

Generate UGC-style AI advertising videos using AI creators

Captions AI Ads API is one of 6 APIs that Captions publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include AI Ads. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.captions.ai/api.

2 operations 2 paths 5 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.mirage.app
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Captions AI Ads API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

AI Ads 2

Generate UGC-style AI advertising videos using AI creators

POST
/ads/submit
Submit AI Ads Video Job
submitAdsJob body → 200400401429
POST
/ads/poll
Poll AI Ads Video Job
pollAdsJob body → 200400401

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are AdsSubmitRequest (5 properties), PollResponse (3 properties), SubmitResponse (1 property), ErrorResponse (1 property). Each schema is shown below with its type and property counts.

AdsSubmitRequest
object
Request body for submitting an AI Ads video generation job.
5 properties 3 required
PollRequest
object
Request body for polling a video generation job
1 property 1 required
ErrorResponse
object
Error response body
1 property
SubmitResponse
object
Response from a job submission containing the operation ID
1 property
PollResponse
object
Job status response. If completed, includes a video URL and state=COMPLETE. If still in flight, includes state (QUEUED or PROCESSING) and a progress value.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

captions-ai-ai-ads-api-openapi.yml Raw ↑

Other APIs Captions publishes across the network.

Captions AI Creator API
Captions Audio API
Captions Meta Text Overlays API
Captions Video Captions API
Captions Videos API