---
title: "Captions integration for LuumenAI"
url: "https://www.luumen.ai/integrations/captions/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Captions integration for LuumenAI

Check Mirage video jobs, pick a caption style, and render on approval

## What LuumenAI can do with Captions

LuumenAI connects to Captions with an API token and exposes 8 tools (5 read-only · 3 write). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 8 tools (5 read-only · 3 write)
- Plan: available on all plans
- Category: AI & automation

## About Captions with LuumenAI

Connect Captions and Luumen can work with your Mirage account from the terminal. It lists video jobs and their progress, reads error details on a stalled render, and pulls up caption styles with their preview URLs. When it is time to generate speech, animate a portrait, or burn captions onto a finished video, the job is previewed first and started once you approve. Luumen authenticates with an API key.

## Example tools

Read-only (5 in total):

- `CAPTIONS_DOWNLOAD_VIDEO` — Download the MP4 content of a completed video job and return an offloaded file reference.
- `CAPTIONS_GET_CAPTION_TEMPLATE` — Retrieve one caption style by ID, including its name and preview video URL.
- `CAPTIONS_GET_VIDEO_STATUS` — Retrieve the current state, progress, and error details for a video generation or captioning job.
- `CAPTIONS_LIST_CAPTION_TEMPLATES` — Return one page of available caption styles, including names and preview video URLs.
- `CAPTIONS_LIST_VIDEOS` — Return one page of video jobs owned by the connected Mirage account, including each job's status and progress.

Write and destructive (3 in total, approval required by default):

- `CAPTIONS_ADD_CAPTIONS` — Start an asynchronous job that transcribes and renders a selected caption style onto an uploaded or existing completed video.
- `CAPTIONS_GENERATE_SPEECH` — Generate WAV speech synchronously from text using a known Mirage voice ID and return an offloaded audio file reference.
- `CAPTIONS_GENERATE_VIDEO` — Start an asynchronous Mirage Video 1 job that animates a portrait image using speech audio.

## Frequently asked questions

### How does LuumenAI connect to Captions?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Captions on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default. Administrators configure that per tool.

### Is there an audit trail?

Every call to Captions — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/captions/