curl --fail-with-body -X GET "$RAWCHUNKS_API/api/voices/$(jq -nr --arg v "$ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
{
"voice": {
"id": "<string>",
"name": "<string>",
"creator": "<string>",
"sample_url": {},
"source_song_id": {},
"status": "<string>",
"error": {},
"availability": {
"turbo": {
"model": "<string>",
"status": "<string>"
},
"sft": {
"model": "<string>",
"status": "<string>"
}
}
}
}Voices
Read a saved voice
Read a voice and model-specific availability.
GET
/
api
/
voices
/
{id}
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/voices/$(jq -nr --arg v "$ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
{
"voice": {
"id": "<string>",
"name": "<string>",
"creator": "<string>",
"sample_url": {},
"source_song_id": {},
"status": "<string>",
"error": {},
"availability": {
"turbo": {
"model": "<string>",
"status": "<string>"
},
"sft": {
"model": "<string>",
"status": "<string>"
}
}
}
}Reference use requires
sample_url. Trained use requires availability.turbo.status or availability.sft.status to be ready for your selected generation mode.
Headers and parameters
string
required
Resource ID.
string
required
Selected account address. Required for owner-scoped reads and writes. It identifies the account; your product must authenticate its own users.
Response (200)
Success.object
required
Show Properties
Show Properties
string
required
string
required
string
required
string | null
string | null
string
required
Values:
saved, extracting, queued, training, ready, error.string | null
Errors
Failed JSON responses contain anerror string. Check the HTTP status before reading a successful result. See job handling for interrupted or uncertain submissions.
| Status | Meaning |
|---|---|
400 | Invalid request. |
403 | Account does not match resource. |
404 | Resource not found. |
409 | Resource conflict; reload state or open an editable version. |
500 | Request failed. |
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/voices/$(jq -nr --arg v "$ID" '$v|@uri')" \
-H "x-session-user-address: $USER_ADDRESS"
⌘I