Get API Key Get API
Docs

Create voice

- Create a reusable voice from a track.

  • Referencing the source track: this endpoint does NOT use task_id + audio_index — provide a publicly accessible audio_url directly
  • Async task: submitting returns a task_id; poll GET /v1/music/tasks/:task_id for the result
Info

Referencing the source track: this endpoint does not use task_id + audio_index; you must directly provide a publicly accessible audio_url (the system extracts the voice from it). If missing, returns 400 audio_url cannot be empty.

Note

This endpoint has no version dimension: do not pass version — if passed, it is discarded and does not affect billing.

Request example

curl -X POST https://api.openveer.com/v1/music/generations/createVoice \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "audio_url": "https://example.com/source.mp3"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K"
    }
  ]
}

Authorizations

Authorization string

All endpoints require authentication using a Bearer Token

Get an API Key:

Visit the API Key management page to get your API Key

Add the following to the request headers when using it:

Authorization: Bearer YOUR_API_KEY

Body

model string

Audio model. Currently pass suno (defaults to suno if omitted).

audio_url string

Publicly accessible URL of the source track; the system extracts the voice from it. Only MP3 / WAV are accepted. If missing, returns 400 audio_url cannot be empty.

Note

Get Results: This API is an asynchronous task. After submission, you will receive task_id; then poll with GET /v1/music/tasks/{task_id}. There is no fixed result.voice_id response format; please display the results based on the actual returned objects and do not use them as persona_id directly.

Response

code integer

Response status code

data array
Returned data array
status string

Task status

  * submitted - Submitted
task_id string

Unique task identifier (used to poll GET /v1/music/tasks/{task_id} for the result)

This documentation is built and hosted on Mintlify, a developer documentation platform.