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 Videos API

Create and list AI-generated videos

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

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

This API exposes 4 operations across 3 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.

4 operations 3 paths 5 schemas 3 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 Videos 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 4

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

Videos 4

Create and list AI-generated videos

POST
/v1/videos
Create Video
createVideo 1 param body → 200422
GET
/v1/videos
List Videos
listVideos 4 params → 200422
GET
/v1/videos/{video_id}
Retrieve Video
getVideo 2 params → 200422
GET
/v1/videos/{video_id}/content
Retrieve Video Content
getVideoContent 2 params → 200422

Schemas 5

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

ValidationError
object
3 properties 3 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
CreateVideoRequest
object
Request body for creating a new AI video generation job. Requires an image reference (JPEG or PNG) and audio reference (WAV or MP3).
3 properties 2 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-videos-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 Video Captions API