Merge branch 'main' into aliottoman-adding-license-patch-2

Author: aliottoman

.DS_Store

@@ -0,0 +1,3 @@
+{
+    "recommendations": []
+}

.vscode/extensions.json

@@ -2,7 +2,7 @@
 
 OCI Speech is an AI service that applies automatic speech recognition technology to transform audio-based content into text. Developers can easily make API calls to integrate OCI Speech’s pre-trained models into their applications. OCI Speech can be used for accurate, text-normalized, time-stamped transcription via the console and REST APIs as well as command-line interfaces or SDKs. You can also use OCI Speech in an OCI Data Science notebook session. With OCI Speech, you can filter profanities, get confidence scores for both single words and complete transcriptions, and more.
 
-Reviewed: 13.11.2024
+Reviewed: 12.05.2025
 
 # Table of Contents
 
@@ -17,7 +17,7 @@ Reviewed: 13.11.2024
 
 # Team Publications
 - [AI Meetings: Meetings transcription](https://www.oracle.com/artificial-intelligence/automate-meeting-transcriptions/)
-- [Search Documents stored in Object Storage using Opensearch, Generative AI, Semantic Search, RAG](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3762)
+- [Create Podcasts with Generative AI](https://www.oracle.com/artificial-intelligence/create-podcasts-with-generative-ai/)
 
 ## Reusable Assets Overview
 
@@ -36,18 +36,19 @@ Reviewed: 13.11.2024
 - [Podcast Generator](https://github.com/oracle-devrel/technology-engineering/tree/main/ai/ai-speech/podcast-generator)
 
 ## Architecture Center
-
+- [Implement a web-based user interface for interacting with Oracle Cloud Infrastructure Generative AI Agents](https://docs.oracle.com/en/solutions/oci-genai-speech/index.html)
 - [Use OCI Speech to transcribe natural language](https://docs.oracle.com/en/solutions/ai-speech/index.html)
 
 ## LiveLabs and Workshops
 
 - [Introduction to OCI Speech](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3135&clear=RR,180&session=106771425893627)
-
+- [Search Documents stored in Object Storage using Opensearch, Generative AI, Semantic Search, RAG](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3762)
+- [Detect and manage offensive behavior in YouTube videos using OCI Data Science, OCI Language, and OCI Speech integrated with APEX](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=3867&clear=RR,180&session=110244305190461)
 
 # Useful Links
 
 - [AI Solutions Hub](https://www.oracle.com/artificial-intelligence/solutions/)
-- [Oracle AI Speech on oracle.com](https://www.oracle.com/uk/artificial-intelligence/speech/)
+- [Oracle AI Speech on oracle.com](https://www.oracle.com/artificial-intelligence/speech/)
 - [Oracle AI Speech documentation](https://docs.oracle.com/en-us/iaas/Content/speech/home.htm)
 - [Oracle Speech AI service now supports diarization](https://blogs.oracle.com/ai-and-datascience/post/oracle-speech-ai-service-now-supports-diarization)
 

ai/ai-speech/README.md

@@ -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.