Get Voice

GET 
https://api.knoxstudio.ai/v1/voices/:voice_id

Fetch one voice. Not billed.

Request

Path Parameters

Name	Type	Required	Description
voice_id	String	Yes	Voice ID.

Query Parameters

Name	Type	Required	Description
with_settings	Boolean	No	Include voice settings in the response.

Request Headers

Name	Type	Required	Description
Authorization	String	Yes	Bearer <token> Knox API key. xi-api-key is also accepted.

cURL Example

curl -X GET "https://api.knoxstudio.ai/v1/voices/21m00Tcm4TlvDq8ikWAM?with_settings=true" \
     -H "Authorization: Bearer $KNOXCHAT_API_KEY"

Response

Success Response (200)

Voice JSON (voice_id, name, samples, optional settings).

Error Responses

Validation uses HTTP 422:

{
  "detail": [
    {
      "loc": ["body", "field"],
      "msg": "…",
      "type": "value_error"
    }
  ]
}

Other errors use { "detail": "message" }.

Status	When
400	WebSocket path called without Upgrade: websocket.
401	Missing or invalid API key.
402	Insufficient credits.
403	Token is not allowed to use this model.
404	Resource not found.
422	Validation error.
429	Rate limit exceeded.
500	Internal server error.