Manage dubbing projects | ElevenLabs Documentation

How-to guide · Assumes you are familiar with creating dubbing projects, as shown in the Dubbing quickstart.

This guide covers the operations you need to manage existing projects: listing them with pagination, retrieving a single project or language, refreshing an expired download URL, and deleting projects and languages you no longer need.

List projects

The list endpoint is cursor-paginated. Pass page_size (up to 100) and an optional status filter, then pass the response’s next_cursor back as cursor to fetch the next page. A next_cursor of null means you have reached the end.

1 import os
2 from dotenv import load_dotenv
3 from elevenlabs.client import ElevenLabs
4 
5 load_dotenv()
6 
7 elevenlabs = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
8 
9 # Fetch every ready project, one page at a time
10 cursor = None
11 while True:
12     page = elevenlabs.dubbing.project.list(
13         page_size=50,
14         status="ready",
15         cursor=cursor,
16     )
17     for project in page.projects:
18         print(project.project_id, project.reference)
19     if page.next_cursor is None:
20         break
21     cursor = page.next_cursor

Retrieve a project or language

Fetch a single project to read its status and media metadata, or a single language to read its status and outputs.

1 project_id = "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3"
2 language_id = "lang_1001kwkyxp0je6ktn4knsfrasx5s"
3 
4 project = elevenlabs.dubbing.project.get(project_id)
5 print(project.status, project.language_ids)
6 
7 language = elevenlabs.dubbing.project.language.get(project_id, language_id)
8 print(language.status, language.target_language)

Refresh an expired download URL

The signed URL in outputs.lossless_audio is valid for about an hour. It is not a permanent link, so store the downloaded file rather than the URL. To download a completed dub again later, fetch the language to obtain a fresh URL.

1 import requests
2 
3 language = elevenlabs.dubbing.project.language.get(project_id, language_id)
4 audio = requests.get(language.outputs.lossless_audio)
5 with open("dubbed.wav", "wb") as f:
6     f.write(audio.content)

Delete projects and languages

Delete a single language target to remove one dub while keeping the project, or delete the project to remove it and all of its languages. Deletion is permanent.

1 # Remove a single language target
2 elevenlabs.dubbing.project.language.delete(project_id, language_id)
3 
4 # Remove the project and all of its languages
5 elevenlabs.dubbing.project.delete(project_id)