The Story Creation Process
When you submit a story creation request, our system begins a multi-stage workflow:Document Processing
Voice Selection
Audio Production
/story/{task_id}
endpoint with the task_id
provided in your initial response.
Supported Document Formats
Our story creation service accepts two popular document formats to accommodate your workflow:Document Type | Supported Formats |
---|---|
Text Files | .txt |
Word Documents | .docx |
Language Configuration
Specifying the correct source language is crucial for successful story creation. To find the appropriate language identifier:- Query the
/source-languages
endpoint for a complete list of supported languages. - Use the returned language ID in your request to ensure accurate processing.
Creating Your First Story
Let’s look at how to initiate a story creation task with Python:Monitoring Your Story Creation Progress
After submission, your content enters our processing pipeline. The time required depends on the length and complexity of your document. You can check progress by polling the status endpoint:Best Practices for Optimal Results
To get the most from our story creation service, consider these professional tips:- Document Quality: Ensure your document is well-formatted with proper grammar and punctuation for better narration results.
- Voice Selection: Choose a narrator voice that matches the tone and style of your story content.
- Language Accuracy: Double-check that your source language is correctly specified to ensure proper pronunciation and pacing.
- Content Length: While our system can handle documents of various lengths, consider breaking very long works into logical segments for optimal processing.
- File Format: Use .docx format when you need to preserve complex formatting, and .txt for simpler text-based stories.
Practical Applications
Our story creation functionality opens exciting possibilities across industries:- Education: Transform educational content into engaging audio lessons for diverse learning styles.
- Publishing: Quickly create audio versions of books, articles, and short stories.
- Content Creation: Convert blog posts and articles into narrated content for podcasts or audio platforms.
- Accessibility: Make written content accessible to visually impaired audiences or those who prefer audio content.
- Entertainment: Bring original stories to life with professional-quality narration.
Authorizations
The x-api-key
is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.
Body
The text file (.txt
) or Word document (.docx
) containing your story content. This document will be used as the basis for the audio book.
The language of the contents in the input file. This helps our system accurately process and narrate your content.
1
, 2
, 3
, 4
, 5
, 6
, 7
, 8
, 9
, 10
, 11
, 12
, 13
, 14
, 15
, 16
, 17
, 18
, 19
, 20
, 21
, 22
, 23
, 24
, 25
, 26
, 27
, 28
, 29
, 30
, 31
, 32
, 33
, 34
, 35
, 36
, 37
, 38
, 39
, 40
, 41
, 42
, 43
, 44
, 45
, 46
, 47
, 48
, 49
, 50
, 51
, 52
, 53
, 54
, 55
, 56
, 57
, 58
, 59
, 60
, 61
, 62
, 63
, 64
, 65
, 66
, 67
, 68
, 69
, 70
, 71
, 73
, 74
, 75
, 76
, 78
, 79
, 80
, 81
, 82
, 83
, 84
, 85
, 86
, 87
, 88
, 90
, 91
, 92
, 93
, 94
, 95
, 96
, 97
, 98
, 99
, 100
, 101
, 102
, 103
, 104
, 106
, 107
, 108
, 109
, 110
, 111
, 112
, 113
, 114
, 115
, 116
, 117
, 118
, 119
, 120
, 121
, 122
, 123
, 124
, 125
, 126
, 127
, 128
, 129
, 130
, 131
, 132
, 133
, 134
, 135
, 136
, 139
, 140
, 141
, 142
, 143
, 144
, 145
, 146
, 148
A descriptive title for your story, making it easier to identify and organize.
3 - 255
A brief synopsis of your story, helping to set context and expectations.
3 - 5000
The identifier of the AI voice that will narrate your story. This determines the tone, accent, and delivery style.
An optional list of dictionary IDs selected by the user. Each entry must be an integer corresponding to a valid dictionary ID. If provided, at least one ID is required.
1
Enter a distinctive name for your project that reflects its purpose or content. This name will be displayed in your CAMB.AI workspace dashboard and used to organize related assets, transcriptions, etc.. . Choose something memorable that helps you quickly identify this specific project among your other voice, audio and localization tasks.
3 - 255
Provide details about your project's goals and specifications. Include information such as the target languages for translation or dubbing, desired voice characteristics, emotional tones to capture, or specific audio processing requirements, outlining the workflow here can serve as valuable documentation for organizational purposes.
3 - 5000
Specify the organizational folder within your CAMB.AI workspace where this task should be created and stored. The folder must already exist in your workspace and be accessible through your current API key authentication. This helps maintain project organization by grouping related tasks together, making it easier to manage and locate your projects.
x >= 1
Response
Successful Response
A JSON that contains the unique identifier for the task. This is used to query the status of the end to end dubbing task that is running. It is returned when a create request is made for a story.