apicheats.dev elevenlabs/llms.txt Raw .md
GET

/v1/studio/projects/{project_id}

ElevenLabs API

Get Studio Project

Base URL
https://api.elevenlabs.io
Auth
xi-api-key: <ELEVENLABS_API_KEY>
Last verified
2026-09-03 · upstream hash matched
Actions
Agents: curl -H "Accept: text/markdown" this URL
→ 181 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/studio/projects/project-id?share_id=share-id' \  -H "xi-api-key: $ELEVENLABS_API_KEY"
Get a free ElevenLabs API key → sponsored

Parameters

Name In Type Required Description
project_id path string Yes The ID of the Studio project.
share_id query string No The share ID of the project

Response 200 OK

{
  "access_level": "viewer",
  "apply_text_normalization": "auto",
  "assets": [],
  "author": "John Doe",
  "base_voices": [],
  "can_be_downloaded": true,
  "chapters": [
    {
      "can_be_downloaded": true,
      "chapter_id": "aw1NgEzBg83R7vgmiJt6",
      "conversion_progress": 0.5,
      "last_conversion_date_unix": 1714204800,
      "last_conversion_error": "Error message",
      "name": "Chapter 1",
      "state": "converting",
      "statistics": {
        "characters_converted": 500,
        "characters_unconverted": 1000,
        "credits_needed_to_convert": 1000,
        "paragraphs_converted": 20,
        "paragraphs_unconverted": 10,
        "voice_statistics": [
          {
            "characters_converted": 300,
            "characters_unconverted": 600,
            "project_voice_ref_id": "voice123",
            "voice_id": "voice123"
          },
          {
            "characters_converted": 200,
            "characters_unconverted": 400,
            "project_voice_ref_id": "voice456",
            "voice_id": "voice456"
          }
        ]
      }
    }
  ],
  "content_type": "Novel",
  "cover_image_url": "https://example.com/cover.jpg",
  "create_date_unix": 1714204800,
  "created_by_user_id": "Vbtgl3bRdj6lk79rYAgx",
  "creation_meta": {
    "creation_progress": 0.5,
    "status": "pending",
    "type": "blank"
  },
  "default_model_id": "eleven_multilingual_v2",
  "default_paragraph_voice_id": "JBFqnCBsd6RMkjVDRZzb",
  "default_paragraph_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb",
  "default_title_voice_id": "JBFqnCBsd6RMkjVDRZzb",
  "default_title_voice_ref_id": "JBFqnCBsd6RMkjVDRZzb",
  "description": "This is a description of my project.",
  "experimental": {},
  "fiction": "fiction",
  "genres": [
    "Novel",
    "Short Story"
  ],
  "isbn_number": "978-90-274-3964-2",
  "language": "en",
  "last_conversion_date_unix": 1714204800,
  "mature_content": false,
  "name": "My Project",
  "original_publication_date": "2025-01-01",
  "project_id": "aw1NgEzBg83R7vgmiJt6",
  "pronunciation_dictionary_locators": [],
  "pronunciation_dictionary_versions": [],
  "public_share_id": "abc123def456789",
  "quality_check_on": false,
  "quality_check_on_when_bulk_convert": false,
  "quality_preset": "standard",
  "state": "default",
  "target_audience": "young adult",
  "title": "My Project",
  "voices": [],
  "volume_normalization": true
}