Voices

Get user voices or system voices

get

Supports pagination and filtering by voice type.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Query parameters

voice_typestring · enumOptional

Voice type filter. "custom" for user-created voices (default), "built-in" for system voices.

Default: customPossible values:

keywordstringOptional

Search keyword (searches voice name, description, labels)

skipintegerOptional

Page number (starts from 0)

Default: 0

limitintegerOptional

Maximum number of items to return per page

Default: 10

Responses

200

Success

application/json

codeintegerOptional

messagestringOptional

400

Invalid parameters

application/json

401

API Key missing or invalid

application/json

get

/voices

HTTP - Get user voicesHTTP - Get system voices

GET /v1/voices?skip=0&limit=10 HTTP/1.1
Host: noiz.ai
Authorization: YOUR_API_KEY
Accept: */*

{
  "code": 1,
  "message": "text",
  "data": {
    "total_count": 1,
    "voices": [
      {
        "id": 1,
        "voice_id": "text",
        "display_name": "text",
        "voice_type": "text",
        "labels": "text",
        "sample": "text",
        "meta": {
          "text": "text"
        },
        "url": "text",
        "create_time": 1
      }
    ]
  }
}

Clone a voice

post

Clone a voice by uploading an audio file or providing an audio URL. Provide either file (upload) or voice_url (remote URL), at least one is required. Only WAV, MP3, and M4A formats are supported.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Body

multipart/form-data

filestring · binaryOptional

Audio file to upload (WAV, MP3, or M4A). Either file or voice_url must be provided.

voice_urlstringOptional

URL to a remote audio file (WAV, MP3, or M4A). Either file or voice_url must be provided.

display_namestringOptional

Display name for the cloned voice

denoisebooleanOptional

Whether to apply noise reduction to the audio

languagestringOptional

Language of the audio (e.g. "en", "zh")

Responses

200

Success

application/json

codeintegerOptional

Status code (0 = success)

messagestringOptional

400

Invalid request / processing error

application/json

401

API Key missing or invalid

application/json

post

/voices

HTTP - Upload fileHTTP - Clone from URL

POST /v1/voices HTTP/1.1
Host: noiz.ai
Authorization: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*

[email protected]&display_name=My Voice

{
  "code": 1,
  "message": "text",
  "data": {
    "voice_id": "text",
    "voice_display_name": "text",
    "duration": 1,
    "selected_text": "text",
    "selected_start": 1,
    "selected_end": 1,
    "text": "text",
    "language": "text"
  }
}

Get voice details

get

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Path parameters

voice_idstringRequired

Responses

200

Success

application/json

codeintegerOptional

messagestringOptional

400

Invalid parameters

401

API Key missing or invalid

application/json

404

Voice not found

application/json

get

/voices/{voice_id}

HTTP

GET /v1/voices/{voice_id} HTTP/1.1
Host: noiz.ai
Authorization: YOUR_API_KEY

{
  "code": 1,
  "message": "text",
  "data": {
    "id": 1,
    "voice_id": "text",
    "display_name": "text",
    "voice_type": "text",
    "labels": "text",
    "sample": "text",
    "meta": {
      "text": "text"
    },
    "url": "text",
    "create_time": 1
  }
}

Delete a voice (soft delete)

delete

Soft delete a voice by setting delete_time. The voice won't be physically removed from storage.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Path parameters

voice_idstringRequired

The ID of the voice to delete

Responses

200

Success

application/json

codeintegerOptional

messagestringOptional

401

API Key missing or invalid

application/json

404

Voice not found

application/json

delete

/voices/{voice_id}

HTTP

DELETE /v1/voices/{voice_id} HTTP/1.1
Host: noiz.ai
Authorization: YOUR_API_KEY

{
  "code": 0,
  "message": "success",
  "data": {
    "voice_id": "abc123def456",
    "display_name": "My Custom Voice",
    "delete_time": 1738664823
  }
}