Merge branch 'main' into oheimbur_2504

Author: oheimburger

.DS_Store

@@ -5,66 +5,82 @@ The application is designed to streamline podcast production through advanced AI
 This application is built using Oracle Visual Builder Cloud Service (VBCS), a powerful low-code platform that simplifies development and accelerates the creation of robust applications without extensive coding. With this low-code approach, even complex workflows are straightforward to set up, allowing developers to focus on leveraging AI's potential for high-quality audio synthesis.
 This AI-powered solution not only automates and optimizes the podcast creation process but also allows content creators to deliver professional audio content at scale efficiently.
 
-Reviewed: 26.11.2024
+Reviewed: 24.04.2025
+
+
+# When to use this asset?
+
+This asset is ideal for developers, content creators, marketers, educators, or any professional looking to:
+
+- **Automate podcast production**: Save time by turning written content into high-quality audio without manual recording or editing.
+- **Enhance content accessibility**: Make blog posts, newsletters, or reports more accessible by offering audio formats.
+- **Create engaging internal communications**: HR or corporate communications teams can quickly generate spoken updates for employees.
+- **Support e-learning**: Teachers or educational platforms can generate audio lessons, summaries, or storytelling content.
+- **Prototype AI-based solutions**: Developers building solutions with Oracle Cloud’s AI services can use this as a reference or starting point.
+- **Demonstrate Oracle Cloud capabilities**: This is a great demo asset for solution engineers and pre-sales teams showcasing OCI GenAI and AI Speech.
+
+Use this asset when you need a scalable, repeatable, and professional way to transform any kind of text into engaging, spoken content—quickly and efficiently.
+
+# How to use this asset?
 
-# **1. Prepare your user**
+## **1. Prepare your user**
 
    In Oracle Cloud Infrastructure (OCI), API keys are used for secure authentication when accessing OCI resources through REST APIs. OCI API keys consist of two parts: a Public key and a Private key. You use the OCI console to generate the Private/Public key pair.
    Generate API Keys using OCI Console
     To Generate the API Keys using OCI Console:
 
   - Login into your OCI Account.
-   ![alt text]![alt text](Podcast-md/ak1.png)
+   ![alt text]![alt text](files/Podcast-md/ak1.png)
   - Click on the Profile icon at the top-right corner and select your Profile hyperlink.
-   ![alt text](Podcast-md/ak2.png)
+   ![alt text](files/Podcast-md/ak2.png)
   - Under Resources section at the bottom-left, select API Keys and then click Add API Key.
-   ![alt text](Podcast-md/ak3.png)
+   ![alt text](files/Podcast-md/ak3.png)
   - The Add API Key dialog is displayed. Select Generate API Key Pair to create a new key pair.
-  ![alt text](Podcast-md/ak4.png)
+  ![alt text](files/Podcast-md/ak4.png)
   - Click Download Private Key. A .pem file is saved to your local device. You do not need to download the public key and click Add button.
-  ![alt text](Podcast-md/ak5.png)
+  ![alt text](files/Podcast-md/ak5.png)
 
 
 
-# **2.Pick you compartment**
+## **2.Pick you compartment**
 Identify the compartment you're currently working within. Navigate to 'Identity' -> 'Compartments'. Locate your compartment and make a note of its OCID (Oracle Cloud Identifier)
 
-# **3.Open Visual Builder**
-## Import Visual Builder project
+## **3.Open Visual Builder**
+### Import Visual Builder project
 * Open Visual Builder and click on the "Import" button. Choose "Application from file".
 * Drop the zip project file
 * Provide a name and an ID, for example "Podcast_Generator". Click on Import button.
- ![alt text](Podcast-md/import_project.jpg)
+ ![alt text](files/Podcast-md/import_project.jpg)
 
-## Configure REST APIs authentication
+### Configure REST APIs authentication
 * Open the recently created project.
 
 * Click on Services button (left side) and click on "Backends"
- ![alt text](Podcast-md/services.jpg)
+ ![alt text](files/Podcast-md/services.jpg)
 
 * Now, click on TTS, and Servers to edit server authentication.
-![alt text](Podcast-md/edit_tts.jpg)
+![alt text](files/Podcast-md/edit_tts.jpg)
 
 * Click the pencil to provide the OCI Crendentials
- ![alt text](Podcast-md/edit_tts_2.jpg)
+ ![alt text](files/Podcast-md/edit_tts_2.jpg)
 
 * Provide the crendentials you got during the step 1.
- ![alt text](Podcast-md/signature.jpg)
+ ![alt text](files/Podcast-md/signature.jpg)
 
 * Repeat the same process with the GenAI backend.
 
-## Provide your compartmentId 
+### Provide your compartmentId 
 * Provide compartmentId default value in the project variable named "comparmentid" that you got during the step 2.
- ![alt text](Podcast-md/compartmentid.jpg)
+ ![alt text](files/Podcast-md/compartmentid.jpg)
 
-#  **4.Preview the application**
+##  **4.Preview the application**
 * Now can provide a topic in the text area and click "generate" button. 
- ![alt text](Podcast-md/preview.jpg)
+ ![alt text](files/Podcast-md/preview.jpg)
 
 * Automatically a podcast script will be created and will generate the audio podcast using the Cindy and Bob voices
-  ![alt text](Podcast-md/generated.jpg)
+  ![alt text](files/Podcast-md/generated.jpg)
 
-## Notes
+### Notes
 * It is important to note that, as of the time of writing this tutorial, the Speech-to-Text service is available exclusively in the Phoenix region.
 
 ## I hope you liked it.