> For the complete documentation index, see [llms.txt](https://tranzo.gitbook.io/tranzo-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tranzo.gitbook.io/tranzo-api/getting-started/quickstart.md).

# Quickstart

To start working with the Tranzo API, you should create an API key on [the dashboard](https://tranzo.io/dashboard):

* Open the dashboard
* Click on the button "Create new API key"
* Give your key a useful name, for example, "Private key for my project X"
* Smash the create button
* You'll see your API key appear on the dashboard
* Click on the button "Copy the key header" in your new key row

Now you have the key's HTTP header copied to your clipboard. You can paste it instead of the `{paste the key header here}`  placeholder and run the console command to see the first result:

```bash
curl -X 'POST' \
  'https://api.tranzo.io/api/v1/translate' \
  -H 'accept: application/json' \
  -H 'Authorization: {paste the key header here}' \
  -H 'Content-Type: application/json' \
  -d '{
  "text": "Привет, мир!",
  "target": "en",
  "source": "ru"
}'
```

You should get the response:

{% code overflow="wrap" %}

```bash
{"translation_id":"147110d1-2cfa-4c4e-8eec-c0cff23a72e4","source":"ru","target":"en","translation":"Hello, world!"}
```

{% endcode %}

Congratulations! You've finished your first request to the Tranzo API. Now let me explain each request parameter:

* **`text`** - It's your text for translation
* **`target`** - the 2-letter code for the language you want to translate to ("en", "fr", etc.)
* **`source`** - the 2-symbol language code of the original text ("en", "fr", etc.). It's an optional parameter. Without it, Tranzo will try to detect the source language by itself.

{% hint style="info" %}
You can get all available languages for "target" and "source" params by requesting [the API language endpoint](https://api.tranzo.io/api/v1/languages)
{% endhint %}

That's all! Now you can use the full power of Tranzo, but pay attention to [the limitations](/tranzo-api/getting-started/publish-your-docs.md)!