Retrieve the list of available AI voices

August 8, 2024

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Runway AI Tools » Audio tools » Generative Audio.
Runway AI Tools » Audio tools » Lip Sync Video.

https://api.useapi.net/v1/runwayml/lipsync/voices/?…

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
Query Parameters
  • email is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes
Responses

  • 200 OK

    [
    {
        "voiceId": "pNInz6obpgDQGcFmaJgB",
        "createdAt": "2024-08-01T01:02:03.456Z",
        "updatedAt": "2024-08-01T01:02:03.456Z",
        "name": "Benjamin",
        "description": "",
        "labels": {
            "accent": "american",
            "description": "deep",
            "age": "middle aged",
            "gender": "male",
            "use case": "narration"
        },
        "privateInTeam": true,
        "createdBy": 1234567,
        "sample": "https://runwayml.cloudfront.net/app/magic-tools/text-to-speech-voice-samples/Benjamin.mp3"
    },
    {
        "voiceId": "XB0fDUnXU5powFXDhCwa",
        "createdAt": "2024-08-01T01:02:03.456Z",
        "updatedAt": "2024-08-01T01:02:03.456Z",
        "name": "Claudia",
        "description": "",
        "labels": {
            "accent": "british-swedish",
            "description": "seductive",
            "age": "young",
            "gender": "female",
            "use case": "characters"
        },
        "privateInTeam": true,
        "createdBy": 1234567,
        "sample": "https://runwayml.cloudfront.net/app/magic-tools/text-to-speech-voice-samples/Claudia.mp3"
    }
]

  • 400 Bad Request

    {
    "error": "<Error message>",
    "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}
Model 
{ // TypeScript, all fields are optional
  voiceId: string,
  createdAt: string,
  lastUsedAt: string,
  name: string,
  description: string,
  labels: {
    accent: string,
    age: string,
    gender: string,
    use_case: string,
    description: string,
    descriptive: string,
    language: string,
    usecase: string,
  }
  privateInTeam: boolean,
  createdBy: number,
  sample: string
}
Examples 
  • curl "https://api.useapi.net/v1/runwayml/lipsync/voices/" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

  • const token = "API token";
const email = "Previously configured email"; 
const apiUrl = `https://api.useapi.net/v1/runwayml/lipsync/voices/?email=${email}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
email = "Previously configured email"
apiUrl = f"https://api.useapi.net/v1/runwayml/lipsync/voices/?email={email}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It