Create Story
Creates a story based on the content provided in a text file (.txt
) or Word document (.docx
)
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.
The Story Creation Process
When you submit a story creation request, our system begins a multi-stage workflow:
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.
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.
Audio Production
The narration is finalized with professional audio quality enhancements, ensuring clarity and engagement.
Throughout this process, you can check on your task’s progress using the /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 |
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-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.
By integrating this API into your workflow, you can efficiently transform written content into engaging audio stories, dramatically reducing the time and expense traditionally associated with professional narration while maintaining impressive quality.
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
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.