Install Jentic One Beta

Connect the NiceVois Agent API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the NiceVois Agent 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%2Fnicevois.com%2Fnicevois" | sh

Step 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%2Fnicevois.com%2Fnicevois" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

What an agent can do with NiceVois Agent API.

Split a song into vocals and instrumental, or lead vocal and backing vocals, with the free split_stems and split_lead_backing tools

Remove background noise or reverb from a voice recording with the free remove_noise and remove_reverb tools

Download each output stem, such as vocal, instrumental, backing_vocals, or clean, through a short-lived link

Quote an RVC training job from durationSeconds and epochs before spending credit

GET STARTED

Start building with NiceVois Agent API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use NiceVois Agent API for, with concrete tasks.

★ Free stem splitting by an agent through Jentic

A music assistant agent asked for an instrumental searches Jentic for 'split a song into vocals and instrumental', receives the createFreeAudioJob schema, and posts tool split_stems with the fileName and sizeBytes. It uploads the file to the returned one-time PUT URL, polls the job no more than every 10 seconds, and downloads the instrumental stem when the status is completed. No NiceVois account is needed for this flow.

Call POST /api/agent/v1/audio-jobs with tool='split_stems', fileName='song.mp3', sizeBytes=5242880, PUT the file to the returned upload URL, poll GET /api/agent/v1/audio-jobs/{jobId} until completed, then fetch the instrumental stem

Cleaning up voice recordings

Podcasters and video creators often record in noisy or echoey rooms. The remove_noise and remove_reverb tools take a WAV, MP3, FLAC, M4A, or OGG voice recording and return a clean output alongside the removed component, and each tool includes its own free minutes per rolling day without an account.

Call POST /api/agent/v1/audio-jobs with tool='remove_noise' and fileName='interview.wav', upload the file, then download the clean stem when the job completes

Training a private RVC voice

Creators who want a voice model of their own can train one without managing GPUs. The agent checks requirements with the capabilities endpoint, reads the welcome credit and balance from the account endpoint, gets an exact price from the quote endpoint, creates the job with fileName, contentType, sizeBytes, durationSeconds, epochs, modelName, and submissionId, uploads the audio, and only then starts training.

Call POST /api/agent/v1/quote with durationSeconds=1200 and epochs=200, confirm the price with the user, create the job with POST /api/agent/v1/jobs, upload the audio, then call POST /api/agent/v1/jobs/{jobId}/start

Converting a vocal with a private model

Once a model is trained or imported, a vocal can be converted into that voice. The agent lists voices to get a modelId, creates a conversion with modelId, fileName, and durationSeconds plus an optional transpose for pitch, uploads the source vocal, and polls until both the normal RVC and NiceVois cleaned outputs are ready. Downloads are authorized one at a time and deduct conversion-download minutes.

Call GET /api/agent/v1/voices, pick the modelId for 'MyVoice', call POST /api/agent/v1/conversions with modelId, fileName='take3.wav', durationSeconds=95, transpose=0, upload the vocal, then poll GET /api/agent/v1/conversions/{conversionId}

Key Endpoints

17 endpoints — the nicevois agent api splits and cleans up audio and trains or applies private rvc v2 voice models.

METHOD

PATH

DESCRIPTION

POST

/api/agent/v1/audio-jobs

Create a free split or cleanup job

GET

/api/agent/v1/audio-jobs/{jobId}

Check a free audio job

GET

/api/agent/v1/audio-jobs/{jobId}/stems/{stem}

Download one output stem

POST

/api/agent/v1/quote

Quote an RVC training job

POST

/api/agent/v1/jobs

Create a private RVC training upload

POST

/api/agent/v1/jobs/{jobId}/start

Start uploaded RVC training

POST

/api/agent/v1/conversions

Create an RVC vocal conversion

POST

/api/agent/v1/audio-jobs

Create a free split or cleanup job

GET

/api/agent/v1/audio-jobs/{jobId}

Check a free audio job

GET

/api/agent/v1/audio-jobs/{jobId}/stems/{stem}

Download one output stem

POST

/api/agent/v1/quote

Quote an RVC training job

POST

/api/agent/v1/jobs

Create a private RVC training upload

POST

/api/agent/v1/jobs/{jobId}/start

Start uploaded RVC training

POST

/api/agent/v1/conversions

Create an RVC vocal conversion

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring NiceVois by hand means handling an OAuth-connected bearer token for account calls, the one-time PUT upload step, and the polling rules for each job type. Through Jentic you install once, import NiceVois from the API Directory, connect your NiceVois token once, and your agent calls it.

Permission scoping

NiceVois separates pricing, upload, and compute into distinct operations, so a rule can limit your agent to the ones it needs, such as free audio jobs and quotes. You choose the operations it may call, so ones that spend credit, like starting training or authorizing conversion downloads, are not included unless you add them.

Credential isolation

Your NiceVois access token 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 'split a song into stems' or 'train a voice model', and Jentic returns the matching NiceVois operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using NiceVois Agent API through Jentic.

What authentication does the NiceVois Agent API use?

Per its OpenAPI spec, account operations such as training, voices, model imports, and conversions use a bearer token in the Authorization header, an OAuth-connected NiceVois access token. The free audio tools, the capabilities endpoints, and the conversion requirements endpoint are open and need no token. Through Jentic, the token is stored encrypted by your own Jentic One instance and injected at call time.

Can I split a song into stems for free with the NiceVois Agent API?

Yes. POST /api/agent/v1/audio-jobs with tool split_stems or split_lead_backing needs no account. The spec says each free tool includes its own 10 free minutes per rolling 24 hours, and outputs are downloaded per stem from GET /api/agent/v1/audio-jobs/{jobId}/stems/{stem}.

What are the rate limits for the NiceVois Agent API?

The OpenAPI spec gives polling guidance rather than a request ceiling: poll free audio jobs and conversions no more than every 10 seconds and training jobs no more than once every 15 seconds. Free tools are limited by minutes of audio per rolling 24 hours. Check https://nicevois.com for current account limits.

How do I remove noise from a recording with the NiceVois Agent API through Jentic?

Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh` and add NiceVois from the Jentic API Directory. Your agent searches for 'remove background noise from audio', calls POST /api/agent/v1/audio-jobs with tool remove_noise, uploads the file to the returned URL, and downloads the clean stem when the job completes. 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 NiceVois Agent API?

Yes. A rule that allows POST /api/agent/v1/quote, GET /api/agent/v1/account, and POST /api/agent/v1/jobs lets the agent price and prepare a training job, while leaving out POST /api/agent/v1/jobs/{jobId}/start means it cannot start cloud compute on its own. Leave out the conversion downloads operation too if download minutes should only be spent with your approval.

Is there a NiceVois MCP server?

Yes, NiceVois describes its agent API as both REST and MCP. You can also connect it directly through Jentic: your agent gets the full 17-endpoint surface from the spec without loading another server's tool definitions into its context, your token is injected at call time by your self-hosted instance instead of living in an MCP config, and your rules decide which operations the agent may call.

Can I use an RVC model I already have with the NiceVois Agent API?

Yes. POST /api/agent/v1/model-imports takes a fileName and sizeBytes and returns a one-time PUT upload instruction for a .pth file or complete model ZIP. After uploading, call GET /api/agent/v1/voices to get its model ID for conversions.

NiceVois Agent API

AI ReadinessAI-Aware (B-)62/100

See full scorecard

Official vendor OpenAPI document · agent-readyMediaAudio Processingbearer17 EndpointsREST

For Agents

Split songs into vocal and instrumental stems, remove noise or reverb from voice recordings for free, and, with an account, quote and run private RVC voice training or convert a vocal with a private model.

Use for: I need to split this song into vocals and instrumental, Remove the background noise from my podcast voice track, Get the acapella from a track for a remix, Remove the reverb from a recording made in a large room

Not supported: Does not generate speech from text, transcribe audio, or master and mix full tracks. Use for stem separation, voice cleanup, and private RVC voice training and conversion only.

The NiceVois Agent API splits and cleans up audio and trains or applies private RVC v2 voice models. Four free tools need no account: split_stems separates vocals from the instrumental, split_lead_backing separates the lead vocal from backing vocals, remove_noise takes background noise out of a voice recording, and remove_reverb removes room echo. With a connected account, the API quotes and runs RVC training jobs, imports existing .pth or ZIP voice models, and converts a vocal with a private model, returning both a normal RVC output and a NiceVois cleaned version. Uploads use one-time PUT URLs, and jobs are polled until outputs are ready.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A-Signals: 4

98%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

46%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: D-Signals: 4

20%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

50%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: B-Signals: 1

60%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A-Signals: 1

75%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the NiceVois Agent API to your agent

Capabilities

Start building with NiceVois Agent API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

NiceVois Agent API

Jentic AI Readiness Score

NiceVois Agent API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness