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 Video Captions API

Add AI captions to videos and manage caption templates

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

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

This API exposes 3 operations across 3 paths, and defines 7 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.

3 operations 3 paths 7 schemas 2 GET1 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 Video Captions 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 3

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

Video Captions 3

Add AI captions to videos and manage caption templates

POST
/v1/videos/captions
Add Captions to a Video
addCaptions 1 param body → 200422
GET
/v1/videos/captions/templates
List Caption Templates
listCaptionTemplates 3 params → 200422
GET
/v1/videos/captions/templates/{template_id}
Retrieve Caption Template
getCaptionTemplate 2 params → 200422

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are MAVideo (12 properties), MACaptionTemplate (5 properties), AddCaptionsRequest (3 properties), MACaptionTemplateList (3 properties). Each schema is shown below with its type and property counts.

ValidationError
object
3 properties 3 required
MACaptionTemplate
object
Represents a caption style template
5 properties 3 required
MACaptionTemplateList
object
Paginated list of caption templates
3 properties 2 required
AddCaptionsRequest
object
Request body for adding captions to a video. Provide either a video file upload or an existing videoid, not both.
3 properties 1 required
HTTPValidationError
object
1 property
MAVideo
object
Represents a video object. A video can be created via generation (image+audio) or captioning (adding captions to an existing video).
12 properties 4 required
MAVideoError
object
Error payload that explains why generation failed, if applicable
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Captions publishes across the network.

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