Localize Voice - Gradium API

POST

/

voice-generator

/

localize

Localize Voice

curl --request POST \
  --url https://api.gradium.ai/api/voice-generator/localize \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "src_voice": "<string>",
  "accent": "<string>",
  "n_samples": 1
}
'

import requests

url = "https://api.gradium.ai/api/voice-generator/localize"

payload = {
    "src_voice": "<string>",
    "accent": "<string>",
    "n_samples": 1
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({src_voice: '<string>', accent: '<string>', n_samples: 1})
};

fetch('https://api.gradium.ai/api/voice-generator/localize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gradium.ai/api/voice-generator/localize",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'src_voice' => '<string>',
    'accent' => '<string>',
    'n_samples' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gradium.ai/api/voice-generator/localize"

	payload := strings.NewReader("{\n  \"src_voice\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"n_samples\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gradium.ai/api/voice-generator/localize")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"src_voice\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"n_samples\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gradium.ai/api/voice-generator/localize")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"src_voice\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"n_samples\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "embeddings": [
    {
      "embedding_id": "<string>",
      "ready": true,
      "expires_at": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

x-api-key

string

header

required

API key for authentication. Passed via the x-api-key header.

Body

application/json

src_voice

string

required

The voice to localize: a voice id (your clone, a converted candidate or a flagship voice) or a vox_emb_ candidate id. The source is not modified.

Required string length: 1 - 64

target_language

enum<string>

required

Language the candidates will speak. May equal the source language: that is an accent change.

Available options:

en,

fr,

es,

pt,

de

accent

string | null

One of the accents GET /voice-generator/available-accents lists for target_language, matched case-insensitively. Omitted: the first accent listed for that language.

Maximum string length: 100

gender

enum<string> | null

Opens the edit caption. Omitted: the source voice's gender tag, or the gender of the source candidate's own localization, or no gender. Clones and converted voices carry no tag, so send it for them.

Available options:

male,

female

n_samples

integer

default:1

Number of candidates to produce. All candidates in one request are variations of the same localized speaker.

Required range: 1 <= x <= 5

Response

Candidates accepted, one per requested sample, in request order, all ready: false.

embeddings

GeneratedEmbedding · object[]

required

Show child attributes

Localize Voice

curl --request POST \
  --url https://api.gradium.ai/api/voice-generator/localize \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "src_voice": "<string>",
  "accent": "<string>",
  "n_samples": 1
}
'

import requests

url = "https://api.gradium.ai/api/voice-generator/localize"

payload = {
    "src_voice": "<string>",
    "accent": "<string>",
    "n_samples": 1
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({src_voice: '<string>', accent: '<string>', n_samples: 1})
};

fetch('https://api.gradium.ai/api/voice-generator/localize', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gradium.ai/api/voice-generator/localize",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'src_voice' => '<string>',
    'accent' => '<string>',
    'n_samples' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gradium.ai/api/voice-generator/localize"

	payload := strings.NewReader("{\n  \"src_voice\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"n_samples\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gradium.ai/api/voice-generator/localize")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"src_voice\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"n_samples\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gradium.ai/api/voice-generator/localize")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"src_voice\": \"<string>\",\n  \"accent\": \"<string>\",\n  \"n_samples\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "embeddings": [
    {
      "embedding_id": "<string>",
      "ready": true,
      "expires_at": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}