# API Translation Mode

## Setup your API KEY

Recommended (free) providers:

* <https://aistudio.google.com/app/apikey>
* <https://console.groq.com/home>
* <https://github.com/zebbern/no-cost-ai?tab=readme-ov-file#chat-interfaces-1>

<div align="left"><figure><img src="https://1153017172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgH4XUgAUFdJrWypZgJFn%2Fuploads%2F0wn4QGWmL5zUudUlZTHz%2Fimage.png?alt=media&#x26;token=bffaebf9-37f6-44b0-bb49-b3f8e929bbe8" alt="" width="375"><figcaption></figcaption></figure></div>

* Press the **`AI API KEY`** to setup your **API KEY**
* Always check read your `API Documentation` to fill the parameters.
* Some API's will require the Advanced tab (Google AI)
* The Advanced tab contains a preset for Google AI but you can try it with other API's.

![](https://1153017172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgH4XUgAUFdJrWypZgJFn%2Fuploads%2F4FF8kat37axGfcvNmn82%2Fimage.png?alt=media\&token=6bb8ee4b-8cad-4396-a18f-a9a27c50c9ee)

* If you claimed the Free Google API Key paste it on the **`PASTE APIKEY HERE`** field.
* (Headers always starts with -H and data will always start with -D)
* Check your preferred API documentation to know wich parameters you have to use.
* Data field will always requiere you to insert the `$prompt$` placeholder inside the prompt parameter field.

## Use the API

<div align="left"><figure><img src="https://1153017172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgH4XUgAUFdJrWypZgJFn%2Fuploads%2FOzBJ0VAP3nedRBVBRRN4%2Fimage.png?alt=media&#x26;token=b0c9541e-8a48-4e8a-b144-7ea3253b7511" alt="" width="299"><figcaption></figcaption></figure></div>

* Select a file from the list

<div align="left"><figure><img src="https://1153017172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgH4XUgAUFdJrWypZgJFn%2Fuploads%2F7LbNlwo8nPImlKoDiCv4%2Fimage.png?alt=media&#x26;token=a068b97c-a115-48ce-9009-89817e307667" alt="" width="296"><figcaption></figcaption></figure></div>

* Press the **`Translate with API`** button

<div align="left"><figure><img src="https://1153017172-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgH4XUgAUFdJrWypZgJFn%2Fuploads%2Fijn75KQFnCKne2RAHMl2%2Fimage.png?alt=media&#x26;token=1b75ff7b-3ad1-46c4-8ce2-28aeb427e67b" alt="" width="375"><figcaption></figcaption></figure></div>

* Set a Request Delay (Time that ReSplitter waits to send the next part)
* Set the Start and End page (By default all the pages are selected)
* Set the Per-Page Tokens (Quantity of characters that each part will contain)
* Press the **`Translate`** button and wait until all parts were finished.
* Press the **`Start Replacement`** button if you agree with translations.

<mark style="color:orange;">**For limited AI's the recommended settings are 30 secs delay and 2500 Per-Page tokens**</mark>\ <mark style="color:orange;">**I recommend using the Google AI that will allow you to use 5 secs and 8000 Per-Page tokens**</mark>\ <mark style="color:orange;">**for free, Google is the best Free API AI for this case i personally recommend it.**</mark>&#x20;