# 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)!


---

# 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://tranzo.gitbook.io/tranzo-api/getting-started/quickstart.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.