Retrieve the list of available AI voices

August 8, 2024 (November 16, 2026)

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

An array of AI voices, each with its voiceId, name, description, labels such as accent, age and gender, and a sample.

The list of AI voices, field by field
{ // 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