# Ditto Audio Models API

**Canonical:** https://apis.io/apis/ditto-audio/ditto-audio-models-api/  
**Provider:** Ditto Audio — https://apis.io/providers/ditto-audio/  
**Base URL:** https://ditto.audio/v1  
**Documentation:** https://ditto.audio/docs/reference

Ditto Audio Models API is one of 30 APIs that [Ditto Audio](https://apis.io/providers/ditto-audio/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Models. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Voice-model catalog — browse, download & upload custom voices

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/models` | Browse the published voice-model catalog |
| GET | `/v1/models/catalog` | The whole published catalogue in one answer, with the version to keep a copy by |
| GET | `/v1/models/languages` | The languages the catalogue has voices recorded in, with how many |
| GET | `/v1/models/taxonomy` | The voice taxonomy: languages, accents (a hierarchy per language), genders… |
| GET | `/v1/models/mine` | Your models — per-user refs joined to catalog metadata (for the reader's Models… |
| GET | `/v1/models/premium/usage` | Your premium-voice quota: used / limit / claimed voices (drives upgrade prompts) |
| GET | `/v1/models/support/rvc` | The RVC engine's support files (ContentVec, FCPE), presigned — what the desktop… |
| GET | `/v1/models/support/pocket` | The Pocket engine's shared ONNX bundle, presigned — what the desktop app… |
| GET | `/v1/models/support/pocket-voices` | Pocket's stock voices, presigned: one reference clip per voice, named for it |
| GET | `/v1/models/support/morpho-tones` | Ditto Morpho's stock tone models, presigned: one folder per model… |
| GET | `/v1/models/{slug}` | Get a published model with its file list (no URLs) |
| GET | `/v1/models/{slug}/samples/{sample}` | Stream a pre-rendered preview clip |
| GET | `/v1/models/{slug}/download` | Get presigned download URLs for every file. |
| GET | `/v1/models/{slug}/files/{fileId}/download` | Get a presigned URL for one file. |
| POST | `/v1/models/custom` | Create a custom XTTS voice and reserve latent upload URLs |
| POST | `/v1/models/custom/{slug}/confirm` | Finalize a custom voice after its latents are uploaded |
| GET | `/v1/models/custom/by-source/{sourceHash}` | Look up YOUR earlier pth→onnx conversion of a source model.pth, by its sha-256 |
| GET | `/v1/models/custom/{slug}/download` | Owner manifest: presigned latents + base voice slug/version |
| DELETE | `/v1/models/custom/{slug}` | Delete a custom voice (blobs + row + ref) |
| GET | `/v1/custom-voices/{id}` | One of your custom voices: metadata, files and preview clips |
| PATCH | `/v1/custom-voices/{id}` | Describe one of your custom voices: name, description, language, accent… |
| DELETE | `/v1/custom-voices/{id}` | Delete one of your custom voices (row, account ref, private files) |
| GET | `/v1/custom-voices/{id}/samples/{sample}` | Stream one of your custom voice's preview clips (owner-only) |
| PUT | `/v1/custom-voices/{id}/samples/{sample}` | Save a preview clip you rendered on your own device (owner-only) |
| GET | `/v1/custom-voices/{id}/download` | Owner manifest: presigned files + the base voice it overlays |
| GET | `/v1/models/imported` | List the user's URL-imported voices |
| POST | `/v1/models/imported` | Register a voice imported from a URL |
| GET | `/v1/models/imported/{id}` | One imported voice |
| PATCH | `/v1/models/imported/{id}` | Rename, or refresh the cached file list after URLs expire |
| DELETE | `/v1/models/imported/{id}` | Remove an imported voice (soft delete) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/ditto-audio/openapi/ditto-audio-models-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-speech-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-create-audio-batch-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-speech-batch-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-create-voice-model-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-update-voice-model-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/ditto-audio/json-schema/ditto-audio-create-custom-voice-dto-schema.json

## Other Ditto Audio APIs (12)

- [Ditto Audio Admin/db API](https://apis.io/apis/ditto-audio/ditto-audio-admin-db-api/)
- [Ditto Audio Admin/inference API](https://apis.io/apis/ditto-audio/ditto-audio-admin-inference-api/)
- [Ditto Audio Admin/models API](https://apis.io/apis/ditto-audio/ditto-audio-admin-models-api/)
- [Ditto Audio API Keys API](https://apis.io/apis/ditto-audio/ditto-audio-api-keys-api/)
- [Ditto Audio Audio API](https://apis.io/apis/ditto-audio/ditto-audio-audio-api/)
- [Ditto Audio Auth API](https://apis.io/apis/ditto-audio/ditto-audio-auth-api/)
- [Ditto Audio Chunks API](https://apis.io/apis/ditto-audio/ditto-audio-chunks-api/)
- [Ditto Audio Docs API](https://apis.io/apis/ditto-audio/ditto-audio-docs-api/)
- [Ditto Audio Favorites API](https://apis.io/apis/ditto-audio/ditto-audio-favorites-api/)
- [Ditto Audio Health API](https://apis.io/apis/ditto-audio/ditto-audio-health-api/)
- [Ditto Audio Inference API](https://apis.io/apis/ditto-audio/ditto-audio-inference-api/)
- [Ditto Audio license (native client) API](https://apis.io/apis/ditto-audio/ditto-audio-license-native-client-api/)

## Tags

Models

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ditto-audio/ditto-audio-models-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ditto-audio/.