Or jump from this list on a smaller screen.
This is a page from the Audivra documentation. Developer exports — index: http://127.0.0.1:3000/docs/llms.txt, full corpus: http://127.0.0.1:3000/docs/llms-full.txt, OpenAPI: http://127.0.0.1:3000/docs/openapi.json, Postman: http://127.0.0.1:3000/docs/postman.json. Press ⌘K to search docs.
Community marketplace
Publish ready clones, browse listings, and pass a listing id as voice_id.
Publishing requires consent that you recorded the voice or have written permission — a versioned consent record is stored. Paid listings need KYC and wait for moderation in production. Listings do not consume an extra custom voice slot. Optional price_credits is metered on each TTS/generate use — the seller receives 70% of those credits and can request a payout. Featured ranking uses uses + ratings from licensed buyers.
/api/v1/voices/communityBrowse published listings. Filter with query, language, or tag. Default sort is featured (uses + ratings).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | No | Search title, description, and tags |
| language | string | No | ISO language code |
| tag | string | No | Single tag filter |
| sort | string | No | featured (default), popular, or recent |
Response
{
"listings": [{ "id": "…", "title": "Warm narrator", "priceCredits": 0 }],
"voices": [{ "id": "…", "source": "community" }]
}Errors
| Status | Meaning |
|---|---|
| 401 | Missing session or API key |
/api/voices/clone/{id}/publishList a ready clone you own. consent must be true.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Clone UUID (path) |
| title | string | Yes | Listing title |
| description | string | No | Short description |
| tags | string[] | No | Up to 8 tags |
| price_credits | integer | No | Extra credits per TTS use (0 = free) |
| consent | boolean | Yes | Must be true |
Request body
{
"title": "Warm narrator",
"description": "Calm Swahili-friendly read",
"tags": ["narration", "warm"],
"price_credits": 0,
"consent": true
}Response
{ "listing": { "id": "…", "status": "published" }, "voice_id": "…" }Errors
| Status | Meaning |
|---|---|
| 401 | Missing session or API key |
| 402 | Paid plan required to publish |
| 404 | Clone not found |
| 400 | KYC required for paid listings, or consent missing |
License and use
POST /api/v1/voices/community/{id} creates a usage grant. Pass the listing UUID as voice_id in TTS. Preview audio: GET /api/v1/voices/community/{id}/preview. Rate a licensed listing with POST /api/v1/voices/community/{id}/reviews. Unlist with DELETE /api/voices/clone/{id}/publish.
Studio: /app/voices → Marketplace. Concept: Community marketplace.