Documentation Index
Fetch the complete documentation index at: https://docs.camb.ai/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Upload a.txt or .docx manuscript and produce narrated audio: full narration, an optional dialogue-only track, and optionally a time-coded transcript. Pick the narrator voice and source language, then run an asynchronous job and fetch URLs when it completes.
Prerequisites
Create an account
Sign up at CAMB.AI Studio if you havenβt already.
Get your API key
Go to Settings β API Keys in Studio and copy your key. See Authentication for details.
Install the SDK
Code
create_story / createStory may return either a task_id (poll as above) or, in some flows, a run_id immediately. If you already have run_id, call get_story_run_info / getStoryRunInfo without polling.How it works
Parameters
Required
| Parameter | Type | Description |
|---|---|---|
file | file stream | .txt or .docx content to narrate |
source_language | Languages | Language of the manuscript (enum / numeric ID) |
Optional
| Parameter | Type | Description |
|---|---|---|
title | string | Story title |
description | string | Short description |
narrator_voice_id | integer | Voice ID for the narrator (use list voices or pick one from Text to Speech) |
folder_id | integer | Folder for organizing the run |
chosen_dictionaries | integer[] | Custom pronunciation dictionaries |
run_id | integer | Optional tracing / linkage |
Tips
- Formats: Use
.txtor.docxas described in the Create Story reference. - Languages: Use Get source languages to choose the correct language ID for
source_language. - URLs: Download links from
audio_urlanddialogue_urlexpire after 24 hoursβfetch and store files promptly. - Polling: Cap your loop (for example 60 attempts Γ 5 seconds) and handle timeouts separately from
ERRORstatus.
Next Steps
Create Story API
Multipart upload and story parameters.
Get Story Status
Poll with
task_id.Get Story Run Info
audio_url, dialogue_url, and optional transcript.Text to Speech
Generate speech and explore voices for
narrator_voice_id.