create_free_audio_job

Split stems, isolate vocals, or remove noise or reverb. No account needed. Each audio tool includes 10 free minutes every 24 hours; subscribers have unlimited use. Returns an upload URL, then use get_free_audio_job.

Argument	Type	Description
tool*	string	split_stems: vocals and instrumental. split_lead_backing: lead vocal, backing vocals, instrumental, and the instrumental with backing vocals. remove_noise: background noise out of a voice recording. remove_reverb: room echo and reverb out of a voice recording.
fileName*	string	The audio file's name with its extension: WAV, MP3, FLAC, M4A or OGG.
sizeBytes*	integer	The file's exact size in bytes.
outputFormat	string	Format of the files you get back. Use wav unless the user asks for another.
durationSeconds	number	The audio's length in seconds, if you can measure it. NiceVois measures the file itself after upload, so leave this out rather than guess.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "tool",
    "fileName",
    "sizeBytes"
  ],
  "properties": {
    "tool": {
      "enum": [
        "split_stems",
        "split_lead_backing",
        "remove_noise",
        "remove_reverb"
      ],
      "type": "string",
      "description": "split_stems: vocals and instrumental. split_lead_backing: lead vocal, backing vocals, instrumental, and the instrumental with backing vocals. remove_noise: background noise out of a voice recording. remove_reverb: room echo and reverb out of a voice recording."
    },
    "fileName": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1,
      "description": "The audio file's name with its extension: WAV, MP3, FLAC, M4A or OGG."
    },
    "sizeBytes": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "The file's exact size in bytes.",
      "exclusiveMinimum": 0
    },
    "outputFormat": {
      "enum": [
        "wav",
        "flac",
        "mp3",
        "ogg"
      ],
      "type": "string",
      "default": "wav",
      "description": "Format of the files you get back. Use wav unless the user asks for another."
    },
    "durationSeconds": {
      "type": "number",
      "maximum": 86400,
      "description": "The audio's length in seconds, if you can measure it. NiceVois measures the file itself after upload, so leave this out rather than guess.",
      "exclusiveMinimum": 0
    }
  }
}

create_training_job

Creates a private NiceVois job and returns a one-time PUT upload URL. Do not ask for consent before the first attempt because NiceVois remembers the current standing account agreement. If the server returns CONSENT_REQUIRED, ask for one acceptance of the linked standing agreement and retry once with acceptsStandingAgreement=true. This allocates a private training slot but does not start GPU work until the audio is uploaded and start_training is called.

Argument	Type	Description
epochs*	integer
fileName*	string	Original WAV, MP3, FLAC, M4A, or OGG filename.
modelName*	string
sizeBytes*	integer
contentType*	string
submissionId*	string
durationSeconds*	number
acceptsStandingAgreement	boolean	Set only when the user explicitly accepts the linked standing voice-training agreement after CONSENT_REQUIRED. Omit for accounts that have already accepted.

create_voice_conversion

Use this when the user has selected a private voice model and wants to convert one vocal recording. Returns a private upload instruction. Upload only the source vocal, then call get_voice_conversion with the same conversion ID.

Argument	Type	Description
modelId*	string	The id returned by list_voice_models.
fileName*	string	Original WAV, MP3, FLAC, M4A, or OGG vocal filename.
sizeBytes	integer	Exact byte size of the source audio. Supply it whenever the client can measure the file so interrupted uploads are verifiable and safely resumable.
transpose	integer	Pitch shift in semitones, from -24 through 24. Use 0 when no shift was requested.
durationSeconds*	number	Measured duration of the source audio in seconds. NiceVois uses this to verify that the account can download the result before cloud work.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "modelId",
    "fileName",
    "durationSeconds"
  ],
  "properties": {
    "modelId": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "The id returned by list_voice_models."
    },
    "fileName": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Original WAV, MP3, FLAC, M4A, or OGG vocal filename."
    },
    "sizeBytes": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Exact byte size of the source audio. Supply it whenever the client can measure the file so interrupted uploads are verifiable and safely resumable.",
      "exclusiveMinimum": 0
    },
    "transpose": {
      "type": "integer",
      "default": 0,
      "maximum": 24,
      "minimum": -24,
      "description": "Pitch shift in semitones, from -24 through 24. Use 0 when no shift was requested."
    },
    "durationSeconds": {
      "type": "number",
      "maximum": 86400,
      "description": "Measured duration of the source audio in seconds. NiceVois uses this to verify that the account can download the result before cloud work.",
      "exclusiveMinimum": 0
    }
  }
}

create_voice_model_import

Use this when the user wants to convert with an existing private RVC .pth file or complete model ZIP instead of a voice trained in their NiceVois library. Returns a one-time PUT upload instruction. After uploading, call list_voice_models to select the imported voice.

Argument	Type	Description
fileName*	string	Original .pth or .zip filename.
sizeBytes*	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "fileName",
    "sizeBytes"
  ],
  "properties": {
    "fileName": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "Original .pth or .zip filename."
    },
    "sizeBytes": {
      "type": "integer",
      "maximum": 524288000,
      "exclusiveMinimum": 0
    }
  }
}

download_voice_conversion_output

Use after get_voice_conversion says the job is complete and the user wants the cleaned or standard output. Each download uses the source audio's duration from the account's conversion-download minutes. If the exact file was downloaded before, ask before retrying and then set confirmRepeat true.

Argument	Type	Description
kind*	string	Prefer cleaned unless the user specifically asks for standard RVC.
eventId	string
conversionId*	string
confirmRepeat	boolean	Only true after the user explicitly confirms downloading the same artifact again.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "conversionId",
    "kind"
  ],
  "properties": {
    "kind": {
      "enum": [
        "cleaned",
        "normal"
      ],
      "type": "string",
      "description": "Prefer cleaned unless the user specifically asks for standard RVC."
    },
    "eventId": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{8,80}$"
    },
    "conversionId": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
    },
    "confirmRepeat": {
      "type": "boolean",
      "default": false,
      "description": "Only true after the user explicitly confirms downloading the same artifact again."
    }
  }
}

get_conversion_requirements

Use this when a user wants to convert vocals with RVC or compare a normal RVC result with NiceVois cleaned consonants and breaths. Returns the real input formats, model choices, workflow, current free-beta policy, and outputs.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_free_audio_job

Use this after create_free_audio_job and the upload, no more than every 10 seconds, until the job is completed or failed. When it completes, it lists every output file (for example lead vocal, backing vocals, instrumental) with a download link.

read-only

Argument	Type	Description
jobId*	string	The id returned by create_free_audio_job.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "The id returned by create_free_audio_job."
    }
  }
}

get_training_account

Call before quoting or creating a training job. Returns the connected account's welcome-credit status, available and reserved balance, balance packs, and a private browser link that keeps checkout on this same agent identity.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_training_job

Use this to check truthful stage, completed epochs, ETA, and artifact readiness for one private NiceVois training job. Poll reasonably; do not call more often than every 15 seconds.

read-only

Argument	Type	Description
jobId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
    }
  }
}

get_training_requirements

Use this before training an AI voice to confirm NiceVois input formats, duration and epoch limits, consent requirements, outputs, retention, and the exact upload workflow.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_voice_conversion

Use this when checking one private NiceVois conversion. Poll no more than once every 10 seconds. Report the returned stage without inventing progress. When complete, present the NiceVois cleaned version first and use download_voice_conversion_output for the version the user requests.

read-only

Argument	Type	Description
conversionId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "conversionId"
  ],
  "properties": {
    "conversionId": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
    }
  }
}

list_free_audio_tools

Use this to see NiceVois's free audio tools (no account needed): split a song into vocals and instrumental (vocal remover, acapella, karaoke instrumental), split lead vocals from backing vocals, remove background noise, and remove reverb or echo. Returns each tool's id, the accepted formats, and a website link to give the user when you cannot upload their file yourself.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_training_jobs

Use this to find the authenticated user's recent NiceVois jobs before asking for a job ID they may not know.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

list_voice_models

Use this when the user wants to convert audio and you need to select one of their private NiceVois-trained or uploaded RVC voices. Do not ask for a model ID before calling this tool.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

quote_training

Call after inspecting the audio and before creating a job. Returns the exact payable amount, current balance, welcome-credit effect, shortfall, feasibility, and the private balance-page link when more balance is needed.

read-only

Argument	Type	Description
epochs*	integer
durationSeconds*	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "durationSeconds",
    "epochs"
  ],
  "properties": {
    "epochs": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991
    },
    "durationSeconds": {
      "type": "number",
      "exclusiveMinimum": 0
    }
  }
}

start_training

Use this only after the source audio was successfully PUT to the upload URL returned by create_training_job. Starts the private cloud RVC training job.

Argument	Type	Description
jobId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
    }
  }
}

NiceVois

Try it

create_free_audio_job

NiceVois

Try it

create_free_audio_job

Tools (16)