Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the cvoice.ai 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%2Fcvoice.ai%2Fcvoice" | 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%2Fcvoice.ai%2Fcvoice" | 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 cvoice.ai API.
Generate AI voice audio from text with a chosen voice ID
Search more than 20,000 characters and their metadata in the public characters dataset
Browse voice IDs grouped by character in the public voices dataset
Read the information tied to your API key
Patterns agents use cvoice.ai API for, with concrete tasks.
GET STARTED
★ Agent-driven voiceover
An AI agent producing narration can pick a voice from the character catalog and generate audio for a line of text in a single call. Because the cvoice.ai API exposes the voice catalog as a public dataset, the agent resolves a character to a voice ID first and then generates, rather than guessing an identifier.
Search the characters dataset for a voice, then generate audio from a line of text using the matching voice ID
Voice discovery
Choosing the right voice means browsing what is available. The cvoice.ai API publishes a characters dataset with metadata and a voices dataset grouping voice IDs by character, so a tool can present options and let a user or agent select before any audio is generated. Both datasets are public and need no key to read.
Load the characters dataset and the voices dataset and present the matching voice IDs for a chosen character
Script-to-audio pipeline
An app that converts written scripts into audio can call the generation endpoint for each line with a consistent voice ID. Keeping the same voice ID across calls produces a continuous narration, and the key-info endpoint lets the pipeline confirm the key is active before a long run.
Generate audio for each line of a script using one voice ID to keep the narration consistent
4 endpoints — the cvoice.
METHOD
PATH
DESCRIPTION
/api/tts
Generate AI voice audio from text for a chosen voice ID
/api/me
Read the information tied to your API key
/dataset_search.json
Public characters dataset with metadata
/dataset_voices.json
Public voices dataset grouped by character
/api/tts
Generate AI voice audio from text for a chosen voice ID
/api/me
Read the information tied to your API key
/dataset_search.json
Public characters dataset with metadata
/dataset_voices.json
Public voices dataset grouped by character
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the cvoice.ai API by hand means handling its X-API-Key header auth, resolving a voice ID from the public datasets, and distinguishing keyed generation from the open dataset reads yourself. Through Jentic you install once, import cvoice from the API Directory, store the key once, and your agent calls it.
Permission scoping
The voice ID and text travel in the request body, not the URL path, so a rule bounds which operations your agent may call rather than which voice it uses. You choose the operations it may call, such as voice generation, so reading your key information is not included unless you add it.
Credential isolation
Your cvoice 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 'generate voice audio from text' or 'find a voice ID', and Jentic returns the matching cvoice operation with its input schema so the agent calls the right endpoint without reading the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using cvoice.ai API through Jentic.
What authentication does the cvoice.ai API use?
The cvoice.ai API authenticates with an API key sent in the X-API-Key header, prefixed cvai_, as declared in its OpenAPI spec. The two public voice datasets need no key to read. Through Jentic the key is stored once and injected at call time, so it never appears in your agent's prompt or logs.
How do I find a voice ID for the cvoice.ai API?
Read the public datasets: the characters dataset lists more than 20,000 characters with metadata, and the voices dataset groups voice IDs by character. An agent resolves a character to a voice ID from these before calling the generation endpoint.
What are the rate limits for the cvoice.ai API?
The spec describes cvoice.ai as a free API with no usage limits, and does not state numeric rate limits. Check the vendor documentation at https://cvoice.ai for current terms before running large batches.
How do I generate voice audio through Jentic with the cvoice.ai API?
Search Jentic for 'generate voice audio from text', which returns the POST /api/tts operation with its input schema, then call it with the text and a voice ID. 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 cvoice.ai API?
Yes. Write a rule that allows only the voice-generation operation, so the agent can turn text into audio but cannot read your key information, and every call it makes is logged. The voice ID and text travel in the request body, so the rule bounds which operations run rather than which voice is used.
For Agents
Generate AI voice audio from text using any of 20,000+ character voices, and look up voice IDs from the public character and voice datasets.
Use for: Generate speech from text in a specific voice, Find a voice ID for a character, Search the voice catalog for a character, List the voices available for a character
Not supported: Does not handle speech-to-text, music generation, or audio hosting. Use for text-to-speech voice generation only.
The cvoice.ai API generates AI voice audio from text using a catalog of more than 20,000 character voices. A single generation call turns text into audio for a chosen voice ID, and two public datasets list the available characters and their voice IDs so callers can pick a voice before generating. An endpoint also returns the information tied to your API key.
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>