API: Swahili ASR (Whisper v2 + Whisper Translate)


📖 To learn more, take a look at our complete API

📤 Example Request

  1. Generate an api key below👇

  2. Install node-fetch & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code and don't use direcly in the browser.

$ npm install node-fetch
$ export GOOEY_API_KEY=sk-xxxx
  1. Use this sample code to call the API.
    If you encounter any issues, write to us at [email protected] and make sure to include the full code snippet and the error message.
import fetch from 'node-fetch';

const payload = {
  "documents": [
    "https://drive.google.com/file/d/1MOP1inJl_HW2nfWOntSDf6Y1qHgSptt1/view?usp=drive_link"
  ],
  "selected_model": "whisper_large_v2",
  "language": "sw",
  "translation_model": "whisper_large_v2",
  "translation_target": "en"
};

async function gooeyAPI() {
  const response = await fetch("https://api.gooey.ai/v2/asr?example_id=sc61r4vx5t1q", {
    method: "POST",
    headers: {
      "Authorization": "bearer " + process.env["GOOEY_API_KEY"],
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
  });

  if (!response.ok) {
    throw new Error(response.status);
  }

  const result = await response.json();
  console.log(response.status, result);
}

gooeyAPI();
  1. Generate an api key below👇

  2. Install requests & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code.

$ python3 -m pip install requests
$ export GOOEY_API_KEY=sk-xxxx
  1. Use this sample code to call the API.
    If you encounter any issues, write to us at [email protected] and make sure to include the full code snippet and the error message.
import os
import requests

payload = {
    "documents": [
        "https://drive.google.com/file/d/1MOP1inJl_HW2nfWOntSDf6Y1qHgSptt1/view?usp=drive_link"
    ],
    "selected_model": "whisper_large_v2",
    "language": "sw",
    "translation_model": "whisper_large_v2",
    "translation_target": "en",
}

response = requests.post(
    "https://api.gooey.ai/v2/asr?example_id=sc61r4vx5t1q",
    headers={
        "Authorization": "bearer " + os.environ["GOOEY_API_KEY"],
    },
    json=payload,
)
assert response.ok, response.content

result = response.json()
print(response.status_code, result)
  1. Generate an api key below👇

  2. Install curl & add the GOOEY_API_KEY to your environment variables.
    Never store the api key in your code.

export GOOEY_API_KEY=sk-xxxx
  1. Run the following curl command in your terminal.
    If you encounter any issues, write to us at [email protected] and make sure to include the full curl command and the error message.
curl 'https://api.gooey.ai/v2/asr?example_id=sc61r4vx5t1q' \
  -H "Authorization: bearer $GOOEY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "documents": [
    "https://drive.google.com/file/d/1MOP1inJl_HW2nfWOntSDf6Y1qHgSptt1/view?usp=drive_link"
  ],
  "selected_model": "whisper_large_v2",
  "language": "sw",
  "translation_model": "whisper_large_v2",
  "translation_target": "en"
}'

🎁 Example Response

{4 Items
"id"
:
string
"ber5x36khijo"
"url"
:
string
"https://gooey.ai/speech/"
"created_at"
:
string
"2024-10-25T11:40:09.211125+00:00"
"output"
:
{2 Items
"raw_output_text"
:
NULL
"output_text"
:
[1 Items
0
:
string
"The Indian economy is the biggest in Kenya, produc"
]
}
}

Please Login to generate the $GOOEY_API_KEY