---
title: "Prepare a private RVC model upload"
method: POST
path: "/api/agent/v1/model-imports"
tags: ["Conversion"]
---

# Prepare a private RVC model upload

`POST /api/agent/v1/model-imports`

## Request

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

Creates a private model import and returns a one-time HTTP PUT upload instruction for a .pth or complete model ZIP. After uploading, list voices again to select the imported model.

## Request body

- CreateModelImport
  - `fileName` string, required: Original .pth or .zip filename.
  - `sizeBytes` integer, required

## Response `201`

Private model upload prepared.

- PendingUpload
  - `id` string, required
  - `status` string, required
  - `upload` UploadInstruction, required
    - `method` 'PUT', required
    - `url` string, uri, required
    - `headers` object, required

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