Skip to main content
Glama

Create an RVC training upload

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "fileName": "<fileName>",
      "contentType": "<contentType>",
      "sizeBytes": "<sizeBytes>",
      "durationSeconds": "<durationSeconds>",
      "epochs": "<epochs>",
      "modelName": "<modelName>",
      "submissionId": "<submissionId>"
    },
    "name": "create_training_job"
  }
}

Input Schema

NameRequiredDescriptionDefault
epochsYes
fileNameYesOriginal WAV, MP3, FLAC, M4A, or OGG filename.
modelNameYes
sizeBytesYes
contentTypeYes
submissionIdYes
trainingEngineNorvc (default): RVC, portable .pth and .index. nicevois: NiceVois Training (Seed-VC with a finishing pass); returns a complete ZIP, not an RVC index. Call quote_training first: the account's remaining shared trial, training pass or eligible subscription determines coverage.
durationSecondsYes
confirmPaidRvcTrainingNoOnly set after the user accepts a paid RVC quote. If FREE_RVC_TRIAL_SETTINGS_CHANGED is returned, show the updated quote and ask the user; never auto-confirm or retry as paid.
acceptsStandingAgreementNoSet only when the user explicitly accepts the linked standing voice-training agreement after CONSENT_REQUIRED. Omit for accounts that have already accepted.

Output Schema

NameRequiredDescriptionDefault
idYes
linksYes
epochsNo
statusYes
uploadYes
etaTextNo
messageNo
artifactsYes
createdAtNo
expiresAtNo
modelNameNo
startedAtNo
updatedAtNo
completedAtNo
currentEpochNo
durationSecondsNo
estimatedCompletionAtNo
estimatedRemainingSecondsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed27 schema fields changed
    • changedOutput schema / properties / artifacts / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "index": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "downloadUrl": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "sizeBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "required": [
      -              "downloadUrl"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "package": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "downloadUrl": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "sizeBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "required": [
      -              "downloadUrl"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "pth": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "properties": {
      -              "downloadUrl": {
      -                "type": "string"
      -              },
      -              "name": {
      -                "anyOf": [
      -                  {
      -                    "type": "string"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "sizeBytes": {
      -                "anyOf": [
      -                  {
      -                    "type": "number"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              }
      -            },
      -            "required": [
      -              "downloadUrl"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "pth",
      -      "index",
      -      "package"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "index": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "downloadUrl": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "sizeBytes": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "downloadUrl"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "package": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "downloadUrl": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "sizeBytes": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "downloadUrl"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "pth": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "properties": {
      +              "downloadUrl": {
      +                "type": "string"
      +              },
      +              "name": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "sizeBytes": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "downloadUrl"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "required": [
      +      "pth",
      +      "index",
      +      "package"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • removedOutput schema / properties / completedAt / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / completedAt / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / createdAt / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / createdAt / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / currentEpoch / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / currentEpoch / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / durationSeconds / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / durationSeconds / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / epochs / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / epochs / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / estimatedCompletionAt / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / estimatedCompletionAt / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / estimatedRemainingSeconds / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / estimatedRemainingSeconds / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / etaText / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / etaText / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / expiresAt / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / expiresAt / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / message / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / message / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / modelName / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / modelName / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / startedAt / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / startedAt / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / updatedAt / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / updatedAt / type
      Added value: +[
      +  "string",
      +  "null"
      +]
  2. Changed2 schema fields changed
    • addedInput schema / properties / confirmPaidRvcTraining
      Added value: +{
      +  "const": true,
      +  "description": "Only set after the user accepts a paid RVC quote. If FREE_RVC_TRIAL_SETTINGS_CHANGED is returned, show the updated quote and ask the user; never auto-confirm or retry as paid.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / trainingEngine / description
      Previous value: -"rvc (default): Standard RVC, portable .pth and .index. nicevois: NiceVois Training (Seed-VC with a finishing pass); returns a complete ZIP, not an RVC index. Requires a training pass or an eligible subscription."New value: +"rvc (default): RVC, portable .pth and .index. nicevois: NiceVois Training (Seed-VC with a finishing pass); returns a complete ZIP, not an RVC index. Call quote_training first: the account's remaining shared trial, training pass or eligible subscription determines coverage."
  3. Changed1 schema field changed
    • changedInput schema / properties / trainingEngine / description
      Previous value: -"rvc (default): Standard RVC, portable .pth and .index. nicevois: NiceVois Training (Seed-VC with a finishing pass); returns a complete ZIP, not an RVC index."New value: +"rvc (default): Standard RVC, portable .pth and .index. nicevois: NiceVois Training (Seed-VC with a finishing pass); returns a complete ZIP, not an RVC index. Requires a training pass or an eligible subscription."
  4. Changed1 schema field changed
    • addedInput schema / properties / trainingEngine
      Added value: +{
      +  "description": "rvc (default): Standard RVC, portable .pth and .index. nicevois: NiceVois Training (Seed-VC with a finishing pass); returns a complete ZIP, not an RVC index.",
      +  "enum": [
      +    "rvc",
      +    "nicevois"
      +  ],
      +  "type": "string"
      +}
  5. First observed

TDQS

A4.1/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare it is a non-read-only, non-destructive, open-world operation; the description adds substantial context beyond that: a private training slot is allocated, the upload URL is one-time, no GPU work starts until upload plus start_training, and the exact consent/retry state machine including the CONSENT_REQUIRED contract. This is the kind of multi-step behavioral disclosure annotations cannot carry.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action and return value, followed by the conditional consent procedure and the lifecycle boundary with start_training. Dense but every sentence is operationally load-bearing; the consent retry rules are verbose but necessary for correct invocation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need not be explained, and the description still gives the key return ('one-time PUT upload URL'). It covers the consent branch and the upload/start_training handoff; the main remaining gap is guidance on the numeric model parameters (epochs, durationSeconds, submissionId) that the schema leaves undocumented.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 40% across 10 parameters, so the description must compensate, but it explains none of the undocumented ones — epochs, modelName, sizeBytes, contentType, submissionId, and durationSeconds carry no meaning in either place. The consent flag behavior is described, but that parameter already documents itself in the schema, so the description adds little net parameter value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Creates a private NiceVois job') plus the concrete return ('one-time PUT upload URL'), and explicitly separates it from the sibling start_training by noting GPU work does not begin until upload and start_training. An agent can distinguish this from start_training and the create_audio_job family without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when/when-not guidance for the consent flow: do not ask for consent on the first attempt, and only on CONSENT_REQUIRED ask once and retry once with acceptsStandingAgreement=true. It also clarifies the pre-condition that a quote_training check governs coverage (in the schema). It stops short of routing between this and other creation siblings such as create_audio_job or create_free_audio_job.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources