POST
/
v1
/
projects
/
{project_id}
/
chapters
/
add
Python
from elevenlabs import ElevenLabs

client = ElevenLabs(
    api_key="YOUR_API_KEY",
)
client.chapters.create(
    project_id="21m00Tcm4TlvDq8ikWAM",
    name="name",
)
{
  "chapter": {
    "chapter_id": "<string>",
    "name": "<string>",
    "last_conversion_date_unix": 123,
    "conversion_progress": 123,
    "can_be_downloaded": true,
    "state": "default",
    "statistics": {
      "characters_unconverted": 123,
      "characters_converted": 123,
      "paragraphs_converted": 123,
      "paragraphs_unconverted": 123
    },
    "last_conversion_error": "<string>"
  }
}
Projects API avaliable upon request. To get access, contact sales.

Headers

​
xi-api-key
string

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.

Path Parameters

​
project_id
string
required

The project_id of the project, you can query GET https://api.elevenlabs.io/v1/projects to list all available projects.

Body

application/json
​
name
string
required

The name of the chapter, used for identification only.

​
from_url
string

An optional URL from which we will extract content to initialize the project. If this is set, 'from_url' must be null. If neither 'from_url' or 'from_document' are provided we will initialize the project as blank.

Response

Successful Response

​
chapter
object
required