cURL
curl --fail-with-body --request GET \
--url "$XPILOT_API_BASE_URL/v1/voices/clone/config" \
--header "Authorization: Bearer $XPILOT_API_KEY"const response = await fetch(process.env.XPILOT_API_BASE_URL + "/v1/voices/clone/config", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.XPILOT_API_KEY}`,
},
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);import os, json, requests
response = requests.request(
"GET",
os.environ["XPILOT_API_BASE_URL"] + "/v1/voices/clone/config",
headers={
"Authorization": "Bearer " + os.environ["XPILOT_API_KEY"],
},
timeout=70,
)
print(response.status_code, response.text)
response.raise_for_status(){
"data": {
"default_voice_version": 1,
"voice_ii_available": true,
"voice_ii_unavailable_reason": "",
"company_name": "X-Pilot",
"locales": [
{
"locale": "en-US",
"consent_statement": "I {voice_talent_name} am aware that recordings of my voice will be used by {company_name} to create and use a synthetic version of my voice."
}
],
"sample_min_seconds": 5,
"sample_max_seconds": 90,
"max_sample_bytes": 31457280
}
}{
"error": {
"code": "invalid_parameter",
"message": "Check parameter types, required fields and idempotency key."
},
"request_id": "<request_id>"
}{
"error": {
"code": "invalid_token",
"message": "Use an active scoped API Key. MCP OAuth tokens cannot call REST."
},
"request_id": "<request_id>"
}{
"error": {
"code": "insufficient_scope",
"message": "Check the credential scope and resource ownership."
},
"request_id": "<request_id>"
}{
"error": {
"code": "rate_limited",
"message": "Credential/workspace rate or concurrency limit reached. Respect Retry-After before retrying.",
"retry_after": 60
},
"request_id": "<request_id>"
}Voices & audio
get voice clone config
Read Voice II clone requirements before clone_voice with voice_version 2: availability, the authorized company_name, supported locales with the consent_statement the speaker must read aloud, and sample duration/size limits. When voice_ii_available is false (for example voice_ii_unavailable_reason clone_disabled), do not attempt a Voice II clone; offer Voice I instead.
GET
/
v1
/
voices
/
clone
/
config
cURL
curl --fail-with-body --request GET \
--url "$XPILOT_API_BASE_URL/v1/voices/clone/config" \
--header "Authorization: Bearer $XPILOT_API_KEY"const response = await fetch(process.env.XPILOT_API_BASE_URL + "/v1/voices/clone/config", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.XPILOT_API_KEY}`,
},
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);import os, json, requests
response = requests.request(
"GET",
os.environ["XPILOT_API_BASE_URL"] + "/v1/voices/clone/config",
headers={
"Authorization": "Bearer " + os.environ["XPILOT_API_KEY"],
},
timeout=70,
)
print(response.status_code, response.text)
response.raise_for_status(){
"data": {
"default_voice_version": 1,
"voice_ii_available": true,
"voice_ii_unavailable_reason": "",
"company_name": "X-Pilot",
"locales": [
{
"locale": "en-US",
"consent_statement": "I {voice_talent_name} am aware that recordings of my voice will be used by {company_name} to create and use a synthetic version of my voice."
}
],
"sample_min_seconds": 5,
"sample_max_seconds": 90,
"max_sample_bytes": 31457280
}
}{
"error": {
"code": "invalid_parameter",
"message": "Check parameter types, required fields and idempotency key."
},
"request_id": "<request_id>"
}{
"error": {
"code": "invalid_token",
"message": "Use an active scoped API Key. MCP OAuth tokens cannot call REST."
},
"request_id": "<request_id>"
}{
"error": {
"code": "insufficient_scope",
"message": "Check the credential scope and resource ownership."
},
"request_id": "<request_id>"
}{
"error": {
"code": "rate_limited",
"message": "Credential/workspace rate or concurrency limit reached. Respect Retry-After before retrying.",
"retry_after": 60
},
"request_id": "<request_id>"
}Documentation by X-Pilot
Required scope:voices:read.
Manage API keys · Authentication and recovery

Authorizations
Scoped X-Pilot API key
Response
Success
