# How to use Bulk Run via API

### Step 1

* Run the TTS models you want to test on the UI. 
* Copy the links of the test runs 

<figure><img src="/files/1EYekmjIL9Kg8NMKWLDb" alt=""><figcaption></figcaption></figure>

### Step 2

* Open Gooey.AI bulk&#x20;
* Head to the API tab&#x20;
* Click on the “curl” tab

<figure><img src="/files/RENVaM7VWEnTYyhoEOev" alt=""><figcaption></figcaption></figure>

EXAMPLE:&#x20;

{% embed url="<https://gooey.ai/bulk/compare-swahili-speech-recognition-ehrfs6a0yukt/api/>" %}

### Step 3

* Add your CSV/google sheet in the documents section (see a screenshot of the CSV example below)&#x20;
* Add your run URLs in the run\_urls section.
* Point to the correct column for the input in input\_columns

```sh
curl 'https://api.gooey.ai/v2/bulk-runner?example_id=ehrfs6a0yukt' \
  -H "Authorization: bearer $GOOEY_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "documents": [
    "https://docs.google.com/spreadsheets/d/1EsQ_NKhyNikNNO3xLV9GOc6C5LTflu9dJ5CSpHqNUQs/edit?gid=0#gid=0"
  ],
  "run_urls": [
   "https://gooey.ai/compare-text-to-speech-engines/?run_id=todlwvm01l31&uid=fm165fOmucZlpa5YHupPBdcvDR02",
   "https://gooey.ai/compare-text-to-speech-engines/?run_id=j8v9fqrfl26o&uid=fm165fOmucZlpa5YHupPBdcvDR02",
    ],
  "input_columns": {
    "text_prompt": "Column Name"
  },
  "output_columns": {
    "price": "Price",
    "run_url": "Run URL",
    "run_time": "Run Time",
    "output_text": "Output Text",
    "raw_output_text": "Raw Output Text"
  }
}'
```

<figure><img src="/files/PXJweUE5PZtmOEmZJsMG" alt=""><figcaption></figcaption></figure>

### How can I calculate the credits?&#x20;

<figure><img src="/files/88qwi3n9SJG0pzbK76Su" alt=""><figcaption></figcaption></figure>

* Please check the credit per run in the sample run you run for your bulk run.&#x20;
* This should be the average cost per run.
* Since you are running Bulk API, you can also check the credits for every run by adding `"price": "Price"` in the `"output_columns"` section


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gooey.ai/tools/evaluations/how-to-use-bulk-run-via-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.