Create Story
Creates a story based on the content provided in a text file (.txt) or Word document (.docx)
POST
Create Story
Transform your written content into engaging narrated stories with our story creation endpoint. This powerful service takes your text documents and processes them into compelling stories with professional narration. The system handles the entire process from parsing your document to generating a professionally narrated version, making storytelling accessible.
Throughout this process, you can check on your task’s progress using the
The Story Creation Process
When you submit a story creation request, our system begins a multi-stage workflow:1
Document Processing
Your uploaded text file or Word document is processed and prepared for narration. Our system extracts and analyzes the content, ensuring proper formatting and structure.
2
Voice Selection
Your chosen AI narrator voice is applied to the story, bringing your content to life with natural-sounding speech patterns and appropriate emotional delivery.
3
Audio Production
The narration is finalized with professional audio quality enhancements, ensuring clarity and engagement.
/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:
This flexibility allows you to work with your preferred writing tools without conversion hassles.
Language Configuration
Specifying the correct source language is crucial for successful story creation. To find the appropriate language identifier:- Query the
/source-languagesendpoint for a complete list of supported languages. - Pass the locale tag (e.g.
"en-us") in your request. Numeric language IDs still work but are deprecated.
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
Body
multipart/form-data
The language of the input text. Pass a locale tag (en-us, fr-fr, es-es). Numeric language IDs (1 or "1") still work but are deprecated. See all source languages.
Example:
"en-us"
Last modified on May 25, 2026