Upload docs_SRT_Translation.md

docs/Translator/docs_SRT_Translation.md

@@ -0,0 +1,80 @@
+# API Documentation for `Lenylvt/SRT_Translation-API`
+
+This documentation covers how to interact with the SRT_Translation API using both Python and JavaScript.
+
+## API Endpoint
+
+To use this API, you can opt for the `gradio_client` Python library [docs](https://www.gradio.app/guides/getting-started-with-the-python-client) or the `@gradio/client` JavaScript package [docs](https://www.gradio.app/guides/getting-started-with-the-js-client).
+
+## Python Usage
+
+### Step 1: Installation
+
+Firstly, install the `gradio_client` if it's not already installed.
+
+```python
+pip install gradio_client
+```
+
+### Step 2: Making a Request
+
+Locate the API endpoint for the function you wish to use. Replace the placeholder values in the snippet below with your actual input data. For accessing private Spaces, you might need to include your Hugging Face token as well.
+
+**API Name**: `/predict`
+
+```python
+from gradio_client import Client
+
+client = Client("Lenylvt/SRT_Translation-API")
+result = client.predict(
+    "https://github.com/gradio-app/gradio/raw/main/test/test_files/sample_file.pdf",  # filepath in 'Upload SRT File' File component
+    "en",  # Source Language (ISO 639-1 code, e.g., 'en' for English) in 'Source Language' Dropdown component
+    "es",  # Target Language (ISO 639-1 code, e.g., 'es' for Spanish) in 'Target Language' Dropdown component
+    api_name="/predict"
+)
+print(result)
+```
+
+**Return Type(s):**
+
+- A `filepath` representing the output in the '*Translated SRT*' File component.
+
+🔴 **If you have this error** : 'Failed to load model for aa to ab: Helsinki-NLP/opus-mt-aa-ab is not a local folder and is not a valid model identifier listed on 'https://huggingface.co/models' If this is a private repository, make sure to pass a token having permission to this repo either by logging in with `huggingface-cli login` or by passing `token=<your_token>`', **its because the language is not available.**
+
+## JavaScript Usage
+
+### Step 1: Installation
+
+For JavaScript, ensure the `@gradio/client` package is installed in your project.
+
+```bash
+npm i -D @gradio/client
+```
+
+### Step 2: Making a Request
+
+As with Python, find the API endpoint that suits your needs. Replace the placeholders with your own data. If accessing a private Space, include your Hugging Face token.
+
+**API Name**: `/predict`
+
+```javascript
+import { client } from "@gradio/client";
+
+const response_0 = await fetch("https://github.com/gradio-app/gradio/raw/main/test/test_files/sample_file.pdf");
+const exampleFile = await response_0.blob();
+                        
+const app = await client("Lenylvt/SRT_Translation-API");
+const result = await app.predict("/predict", [
+    exampleFile,  // blob in 'Upload SRT File' File component        
+    "en",         // string in 'Source Language' Dropdown component        
+    "es",         // string in 'Target Language' Dropdown component
+]);
+
+console.log(result.data);
+```
+
+**Return Type(s):**
+
+- `undefined` representing the output in the '*Translated SRT*' File component.
+
+🔴 **If you have this error** : 'Failed to load model for aa to ab: Helsinki-NLP/opus-mt-aa-ab is not a local folder and is not a valid model identifier listed on 'https://huggingface.co/models' If this is a private repository, make sure to pass a token having permission to this repo either by logging in with `huggingface-cli login` or by passing `token=<your_token>`', **its because the language is not available.**