📖 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://docs.google.com/spreadsheets/d/1tcLnRA6IctAzsJRfL_UXGsrtrhZj3qQ70J6TBZ-jZ9g/edit?gid=1908709183#gid=1908709183"
  ],
  "run_urls": [
    "https://gooey.ai/speech/kinyarwanda-mms-google-mt-wtkli0abj9zu/",
    "https://gooey.ai/speech/kinyarwanda-sunbird-asr-google-mt-ye7qj3od496s/",
    "https://gooey.ai/speech/kinyarwanda-gpt-4o-audio-google-mt-bxhkwv27lk08/",
    "https://gooey.ai/speech/kinyarwanda-mms-ghananlp-6jybhfgwkyuy/",
    "https://gooey.ai/speech/kinyarwanda-gpt-4o-audio-no-mt-utmyauiaqa6k/",
    "https://gooey.ai/speech/kinyarwanda-google-chirp-google-mt-3fs4qsq4qkmm/",
    "https://gooey.ai/speech/mbaza-asr-google-translate-kinyarwanda-en-8fwktqsnalrx/"
  ],
  "input_columns": {
    "documents": "File_path"
  },
  "output_columns": {
    "run_url": "Run URL",
    "run_time": "Run Time",
    "output_text": "Output Text",
    "raw_output_text": "Raw Output Text"
  }
};

async function gooeyAPI() {
  const response = await fetch("https://api.gooey.ai/v2/bulk-runner?example_id=c0kgb4piorq0", {
    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://docs.google.com/spreadsheets/d/1tcLnRA6IctAzsJRfL_UXGsrtrhZj3qQ70J6TBZ-jZ9g/edit?gid=1908709183#gid=1908709183"
    ],
    "run_urls": [
        "https://gooey.ai/speech/kinyarwanda-mms-google-mt-wtkli0abj9zu/",
        "https://gooey.ai/speech/kinyarwanda-sunbird-asr-google-mt-ye7qj3od496s/",
        "https://gooey.ai/speech/kinyarwanda-gpt-4o-audio-google-mt-bxhkwv27lk08/",
        "https://gooey.ai/speech/kinyarwanda-mms-ghananlp-6jybhfgwkyuy/",
        "https://gooey.ai/speech/kinyarwanda-gpt-4o-audio-no-mt-utmyauiaqa6k/",
        "https://gooey.ai/speech/kinyarwanda-google-chirp-google-mt-3fs4qsq4qkmm/",
        "https://gooey.ai/speech/mbaza-asr-google-translate-kinyarwanda-en-8fwktqsnalrx/",
    ],
    "input_columns": {"documents": "File_path"},
    "output_columns": {
        "run_url": "Run URL",
        "run_time": "Run Time",
        "output_text": "Output Text",
        "raw_output_text": "Raw Output Text",
    },
}

response = requests.post(
    "https://api.gooey.ai/v2/bulk-runner?example_id=c0kgb4piorq0",
    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/bulk-runner?example_id=c0kgb4piorq0' \
  -H "Authorization: bearer $GOOEY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "documents": [
    "https://docs.google.com/spreadsheets/d/1tcLnRA6IctAzsJRfL_UXGsrtrhZj3qQ70J6TBZ-jZ9g/edit?gid=1908709183#gid=1908709183"
  ],
  "run_urls": [
    "https://gooey.ai/speech/kinyarwanda-mms-google-mt-wtkli0abj9zu/",
    "https://gooey.ai/speech/kinyarwanda-sunbird-asr-google-mt-ye7qj3od496s/",
    "https://gooey.ai/speech/kinyarwanda-gpt-4o-audio-google-mt-bxhkwv27lk08/",
    "https://gooey.ai/speech/kinyarwanda-mms-ghananlp-6jybhfgwkyuy/",
    "https://gooey.ai/speech/kinyarwanda-gpt-4o-audio-no-mt-utmyauiaqa6k/",
    "https://gooey.ai/speech/kinyarwanda-google-chirp-google-mt-3fs4qsq4qkmm/",
    "https://gooey.ai/speech/mbaza-asr-google-translate-kinyarwanda-en-8fwktqsnalrx/"
  ],
  "input_columns": {
    "documents": "File_path"
  },
  "output_columns": {
    "run_url": "Run URL",
    "run_time": "Run Time",
    "output_text": "Output Text",
    "raw_output_text": "Raw Output Text"
  }
}'

🎁 Example Response

{4 Items
"id"
:
string
"mmwy356vcm0e"
"url"
:
string
"https://gooey.ai/bulk/"
"created_at"
:
string
"2025-08-25T14:25:28.736374+00:00"
"output"
:
{2 Items
"output_documents"
:
[1 Items
0
:
string
"https://storage.googleapis.com/dara-c1b52.appspot."
]
"eval_runs"
:
[1 Items
0
:
string
"https://gooey.ai/eval/?run_id=6oc0kttx60ho&uid=fm1"
]
}
}

Please Login to generate the $GOOEY_API_KEY