---
title: "Create an RVC vocal conversion"
method: POST
path: "/api/agent/v1/conversions"
tags: ["Conversion"]
---

# Create an RVC vocal conversion

`POST /api/agent/v1/conversions`

## Request

- Base URL: `https://nicevois.com`
- URL: `https://nicevois.com/api/agent/v1/conversions`
- Auth: HTTP bearer

Creates one private conversion and returns a one-time HTTP PUT source-vocal upload instruction. Upload the vocal, then check the returned conversion ID no more than every 10 seconds.

## Request body

- CreateConversion
  - `modelId` string, required: A private id returned by listVoiceModels.
  - `fileName` string, required: Original WAV, MP3, FLAC, M4A, or OGG source-vocal filename.
  - `sizeBytes` integer: Exact source-audio byte size used to verify and resume private uploads.
  - `durationSeconds` number, required: Measured duration used to verify that the account can retrieve the result before cloud work.
  - `transpose` integer

## Response `201`

Conversion created; upload the exact source vocal to upload.url.

- ConversionJob
  - `id` string, required
  - `status` string, required
  - `modelName` string, nullable
  - `fileName` string, nullable
  - `transpose` integer, nullable
  - `stage` string, nullable
  - `stageMessage` string, nullable
  - `providerState` string, nullable
  - `createdAt` string, date-time, nullable
  - `error` string, nullable
  - `upload` UploadInstruction
    - `method` 'PUT', required
    - `url` string, uri, required
    - `headers` object, required
  - `outputs` object, nullable
    - `normal` ConversionOutput, required
      - `listenUrl` string, uri, required
      - `downloadUrl` string, uri, nullable
    - `cleaned` ConversionOutput, required
      - `listenUrl` string, uri, required
      - `downloadUrl` string, uri, nullable
  - `timings` object, nullable
  - `restoration` object, nullable

## Other responses

- `400`: Invalid input or missing consent.
- `401`: Missing or invalid NiceVois agent credential.

---

[API](https://skmtc.dev/nicevois/apis/nicevois-agent-api.md) · [All operations](https://skmtc.dev/nicevois/apis/nicevois-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicevois/apis/nicevois-agent-api/revisions/6ef41022a089?raw)