---
title: "Authorize one voice-conversion download"
method: POST
path: "/api/agent/v1/conversions/{conversionId}/downloads"
tags: ["Conversion"]
---

# Authorize one voice-conversion download

`POST /api/agent/v1/conversions/{conversionId}/downloads`

## Request

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

Returns a short-lived download URL and deducts the source audio duration from conversion-download minutes. Normal and cleaned files both count. Set confirmRepeat only after the user confirms downloading the exact same artifact again.

## Path parameters

- `conversionId` string, required

## Request body

- CreateConversionDownload
  - `kind` 'cleaned' | 'normal', required
  - `confirmRepeat` boolean
  - `eventId` string

## Response `201`

Download authorized and metered.

- ConversionDownload
  - `accepted` boolean, required
  - `downloadUrl` string, uri, required
  - `downloadCount` integer, required
  - `secondsCharged` integer, required

## Other responses

- `401`: Missing or invalid NiceVois agent credential.
- `402`: The connected account needs more training balance. The error includes the exact shortfall and a short-lived same-account browser link.
- `404`: The private job was not found for this credential.
- `409`: The exact artifact was already downloaded and needs explicit repeat confirmation.

---

[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)