API Reference
SDK Libraries
Endpoints
- Text to Speech
- Voice Changer
- Sound Effects
- Audio Isolation
- Text to Voice
- Dubbing
Administration
- History
- Samples
- User
- Voices
- Voice Library
- Projects
- GETGet Projects
- GETGet Project By Id
- POSTAdd Project
- DELDelete Project
- POSTConvert Project
- GETGet Project Snapshots
- POSTStream Project Audio
- GETGet Chapters
- GETGet Chapter By Id
- POSTAdd Chapter To A Project
- DELDelete Chapter
- POSTConvert Chapter
- GETGet Chapter Snapshots
- POSTStream Chapter Audio
- POSTUpdate Pronunciation Dictionaries
- GET
- Pronunciation Dictionaries
- Models
- Audio-native
- Workspace
- Usage
Legacy
- Voice Generation (Deprecated)
Projects
Add Project
Creates a new project, it can be either initialized as blank, from a document or from a URL.
POST
/
v1
/
projects
/
add
Copy
Ask AI
from elevenlabs import ElevenLabs
client = ElevenLabs(
api_key="YOUR_API_KEY",
)
client.projects.add(
name="name",
default_title_voice_id="default_title_voice_id",
default_paragraph_voice_id="default_paragraph_voice_id",
default_model_id="default_model_id",
)
Copy
Ask AI
{
"project": {
"project_id": "<string>",
"name": "<string>",
"create_date_unix": 123,
"default_title_voice_id": "<string>",
"default_paragraph_voice_id": "<string>",
"default_model_id": "<string>",
"last_conversion_date_unix": 123,
"can_be_downloaded": true,
"title": "<string>",
"author": "<string>",
"description": "<string>",
"genres": [
"<string>"
],
"cover_image_url": "<string>",
"target_audience": "children",
"language": "<string>",
"content_type": "<string>",
"original_publication_date": "<string>",
"mature_content": true,
"isbn_number": "<string>",
"volume_normalization": true,
"state": "creating",
"access_level": "admin",
"fiction": "fiction",
"quality_check_on": true,
"quality_check_on_when_bulk_convert": true,
"creation_meta": {
"creation_progress": 123,
"status": "pending",
"type": "blank"
}
}
}
Projects API avaliable upon request. To get access, contact sales.
Headers
Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.
Body
multipart/form-data
Response
200
application/json
Successful Response
The response is of type object
.
Was this page helpful?
Copy
Ask AI
from elevenlabs import ElevenLabs
client = ElevenLabs(
api_key="YOUR_API_KEY",
)
client.projects.add(
name="name",
default_title_voice_id="default_title_voice_id",
default_paragraph_voice_id="default_paragraph_voice_id",
default_model_id="default_model_id",
)
Copy
Ask AI
{
"project": {
"project_id": "<string>",
"name": "<string>",
"create_date_unix": 123,
"default_title_voice_id": "<string>",
"default_paragraph_voice_id": "<string>",
"default_model_id": "<string>",
"last_conversion_date_unix": 123,
"can_be_downloaded": true,
"title": "<string>",
"author": "<string>",
"description": "<string>",
"genres": [
"<string>"
],
"cover_image_url": "<string>",
"target_audience": "children",
"language": "<string>",
"content_type": "<string>",
"original_publication_date": "<string>",
"mature_content": true,
"isbn_number": "<string>",
"volume_normalization": true,
"state": "creating",
"access_level": "admin",
"fiction": "fiction",
"quality_check_on": true,
"quality_check_on_when_bulk_convert": true,
"creation_meta": {
"creation_progress": 123,
"status": "pending",
"type": "blank"
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.