Welcome to the Spoken Studio API
Unlock the power of AI-driven audio publishing with Spoken Studio API. Whether you are a publisher, a platform partner, or a developer, the Spoken Studio API gives you the tools to onboard your authors, spin up audio projects, and ingest high-quality audio files, all with a few simple calls.
Authors can launch Spoken Studio directly from partner websites in seconds using our Easy-Peasy URL
Give your authors instant access to single narrator, duet narration, dual narrator, or multi-voice AI audiobook creation — no setup, no friction. With a single parameterized URL, you can launch Spoken Studio for any user (requires the user also have a Spoken account)
All you need:
- A valid authentication token, which you can retrieve from the API link below
- Your
clientId, also available using the link below - A unique
externalProjectIdfor each project. You can test with the Welcome to the Audioverse ePub project from the link below. - Optional parameter: Project Title
- Optional parameter: Project Author Name
With this link syntax:
https://ihave.spoken.press/create/manager?externalProjectId={EXTERNAL_PROJECT_ID}&clientId={CLIENT_ID};title:{projecttitle};author{authorname}
Example of a Server-Side Callback to Fetch the Author's Story
Once the author is redirected to Spoken Studio, we can initiate a server-side request to your endpoint using the project_id.
Request example:
POST https://yourdomain.com/api/path/epub
Authorization: Bearer {ACCESS_TOKEN}
{
"project_id": "abc-123"
}Expected client response:
{
"epub_url": "https://yourdomain.com/path/to/story.epub"
}Spoken will then ingest the manuscript files (.epub, .docx, or .pdf).
Project Status and Audio Retrieval using Spoken Studio API
Programmatically check any project status and retrieve MP3 audio files. These endpoints allow you to fetch:
- Status of narration for all installments (chapters). Use the Project ID from your project URL to try it out.
- All installments (chapters or segments) for a project
- A single audio file for a specific installment. Use the Installment ID from your project's Project Manager tab (click the individual installment below) to try it out.