Voice Clones

Voice clone APIs manage saved voice profiles for the active business. Creating a voice profile is available on Agency plans and higher and does not spend video credits. Using a saved voice in a completed video composite follows the normal video/composite credit rules. Provider voice identifiers are never returned. API responses use NearIQ voice profile IDs only.

Plan limits

Plan	Saved voice profiles
Starter	0
Growth	0
Agency	1
Enterprise	2
Scale	3
Unlimited	5

List voice profiles

curl https://app.neariq.io/api/businesses/me/voice-clones

{
  "clones": [
    {
      "id": "b8e41b98-8a18-4f98-a9d4-7c4a56a104c2",
      "name": "Owner voice",
      "isDefault": true,
      "createdAt": "2026-05-14T12:00:00.000Z",
      "updatedAt": "2026-05-14T12:00:00.000Z",
      "lastUsedAt": null
    }
  ],
  "count": 1,
  "limit": 1,
  "canCreate": false,
  "voiceCloningEnabled": true,
  "unavailableReason": "You've used all 1 voice clone slots on your plan."
}

Create a voice profile

POST /api/businesses/me/voice-clones accepts multipart/form-data.

Field	Type	Required	Notes
`audio`	file	yes	MP3, WAV, M4A, OGG, or WebM. Max 10 MB.
`name`	string	no	Display name, max 80 characters.
`consentConfirmed`	boolean string	yes	Must be `true`.

curl https://app.neariq.io/api/businesses/me/voice-clones \
  -X POST \
  -F "name=Owner voice" \
  -F "consentConfirmed=true" \
  -F "audio=@voice-sample.wav"

Update a voice profile

PATCH /api/businesses/me/voice-clones renames a profile or sets it as the business default narration voice.

{
  "id": "b8e41b98-8a18-4f98-a9d4-7c4a56a104c2",
  "isDefault": true
}

Delete a voice profile

curl "https://app.neariq.io/api/businesses/me/voice-clones?id=b8e41b98-8a18-4f98-a9d4-7c4a56a104c2" \
  -X DELETE

If the deleted profile was the default and another profile remains, NearIQ marks the oldest remaining profile as default.

Access

Users must be authenticated and have access to the active business. Organization members need the manage_voice permission for create, update, and delete actions.

API Reference

Endpoints

Webhooks

Plan limits

List voice profiles

Create a voice profile

Update a voice profile

Delete a voice profile

Access

​Plan limits

​List voice profiles

​Create a voice profile

​Update a voice profile

​Delete a voice profile

​Access

Plan limits

List voice profiles

Create a voice profile

Update a voice profile

Delete a voice profile

Access