Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the AirCaps API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Faircaps.com%2Faircaps" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Faircaps.com%2Faircaps" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with AirCaps API.
Transcribe uploaded English audio into text and download the result as subtitles
Diarize a recording to separate speaker turns and download the result as RTTM
Identify a speaker by matching audio against voiceprints you enrol under a speaker record
Enrol and manage speakers and their enrolment samples for recurring identification
Upload audio directly or request a presigned upload URL for larger files
GET STARTED
Read account details, usage, and the models available for each speech task
Patterns agents use AirCaps API for, with concrete tasks.
★ Agent-Driven Meeting Transcription and Attribution
An agent handling a recorded meeting can upload the audio, create an asynchronous transcript, and create a diarization, then combine the transcript text with the speaker turns so each line is attributed to a speaker. Transcripts download as subtitles and diarizations download as RTTM, giving the agent both human-readable captions and a machine-readable speaker timeline. This produces an attributed transcript without the agent running any speech model itself.
Upload a meeting recording, create a transcript and a diarization for it, then download the subtitles and the RTTM and align speaker turns to the transcript lines.
Voice-Based Speaker Identification
To recognise known voices, you enrol each speaker with one or more voice samples under a speaker record, then run synchronous identification on new audio to find the best match. Because identification is synchronous, an agent gets the result in the same call rather than polling, which suits live or interactive flows. Enrolments can be added or removed over time to keep a speaker's voiceprint current.
Create a speaker, add an enrolment from a voice sample, then run speaker identification on a new clip and report the matched speaker id.
Generating Subtitles for Video
A publishing workflow can transcribe a video's audio track and download the transcript as subtitles ready to attach to the video. The transcript is created asynchronously, so an agent submits the audio, waits for completion, and then fetches the subtitle file. This gives a hands-off path from a raw recording to caption files without a local speech pipeline.
Create a transcript from a video's audio, poll until it is ready, and download its subtitles for attachment to the video.
23 endpoints — the aircaps api transcribes english speech to text, separates who spoke when, and identifies known speakers from their voice.
METHOD
PATH
DESCRIPTION
/v1/transcripts
Create an asynchronous transcript
/v1/transcripts/{id}/subtitles
Download a transcript as subtitles
/v1/diarizations
Create a speaker diarization
/v1/diarizations/{id}/rttm
Download the diarization as RTTM
/v1/speakers
Create a speaker record
/v1/speakers/identify
Identify a speaker from audio synchronously
/v1/files
Upload an audio file
/v1/models
List models available per task
/v1/transcripts
Create an asynchronous transcript
/v1/transcripts/{id}/subtitles
Download a transcript as subtitles
/v1/diarizations
Create a speaker diarization
/v1/diarizations/{id}/rttm
Download the diarization as RTTM
/v1/speakers
Create a speaker record
/v1/speakers/identify
Identify a speaker from audio synchronously
/v1/files
Upload an audio file
/v1/models
List models available per task
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the AirCaps API by hand means sending your Bearer aircaps_sk_ key on every call, handling the asynchronous transcript and diarization lifecycle, and arranging audio uploads either inline or through a presigned URL. Through Jentic you install once, import it from the API Directory, store the API key once, and your agent calls the transcript, diarization, and speaker operations.
Permission scoping
AirCaps puts the transcript and speaker ids in the URL path (/v1/transcripts/{id}, /v1/speakers/{id}), so a rule can limit your agent to the operations you pick: it can create and read transcripts and nothing else. You choose the operations it may call, so destructive ones like transcript, speaker, or enrolment deletion are not included unless you add them.
Credential isolation
Your AirCaps API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'transcribe an audio file' or 'identify a speaker', and Jentic returns the matching AirCaps operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using AirCaps API through Jentic.
What authentication does the AirCaps API use?
Per its OpenAPI spec the AirCaps API uses an HTTP bearer scheme: you send your API key as an Authorization header in the form Bearer aircaps_sk_... over HTTPS. The bearer key applies to the transcript, diarization, speaker, file, account, and usage operations; the models listing is the one open read that needs no key.
Can I separate who spoke when with the AirCaps API?
Yes. Create a diarization from a recording and the API returns the speaker turns, which you can also download as an RTTM file. To attach names to those turns, enrol each voice as a speaker and run synchronous speaker identification, which returns the best-matching speaker for a clip in the same call.
What are the rate limits for the AirCaps API?
The OpenAPI spec does not publish numeric rate limits for the AirCaps API; the account and usage operations report your current consumption so you can track it. For current limits check the vendor documentation at https://docs.aircaps.com.
How do I transcribe an audio file with the AirCaps API through Jentic?
Import the AirCaps API from the Jentic API Directory, then have your agent search by intent such as 'transcribe an audio file' and Jentic returns the create-transcript operation with its input schema. The agent uploads the file, creates the transcript, and downloads the subtitles once it is ready. To run it on your own infrastructure, install Jentic One from its GitHub repo.
Can I limit what my agent is allowed to do with the AirCaps API?
Yes. AirCaps carries the transcript and speaker ids in the URL path, so write a rule that allows only the create and read operations your task needs, and your agent can transcribe and read results but cannot delete transcripts, speakers, or enrolments. Add the delete operations only when the agent genuinely needs them, and every call it makes is logged.
Is there an AirCaps MCP server?
You don't need an MCP server to give your agent the AirCaps API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the transcript, diarization, and speaker operations on demand without loading another server's tool definitions into its context.
Does the AirCaps API support languages other than English?
Per the spec the transcription models are described for English, and the models listing reports the engines available for each task so you can confirm what a given model supports. Diarization and speaker identification work from the audio signal rather than the words, so they are not tied to a single language.
For Agents
Transcribe English audio, diarize who spoke when, and identify enrolled speakers through REST. Create and read transcripts, diarizations, and speaker records; download subtitles and RTTM; and manage speaker enrolments and uploaded files.
Use for: Transcribe an English audio recording to text, Get the subtitles for a finished transcript, Diarize a meeting recording to separate who spoke when, Identify which enrolled speaker is talking in a clip
Not supported: Does not synthesize speech, translate text, or transcribe non-English languages beyond its listed models. Use for English speech-to-text, diarization, and speaker identification only.
The AirCaps API transcribes English speech to text, separates who spoke when, and identifies known speakers from their voice. It creates asynchronous transcripts from uploaded audio and returns them as text or downloadable subtitles, produces speaker diarizations with downloadable RTTM, and runs synchronous speaker identification against voiceprints you enrol. You manage speakers and their enrolments, upload files directly or via a presigned URL, and read account and usage details. A models listing reports the engines available for each task.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>