# Quick start

> Первый запрос к OpenAI-совместимому API за пять минут — base_url, API-ключ, примеры на curl, Python и JavaScript.

Веб-версия: https://ai.trackly.one/developers/docs · Индекс документации: https://ai.trackly.one/llms.txt

## Base URL

API полностью совместим с OpenAI: работает любой OpenAI SDK и любой готовый
код — меняются только два параметра.

```text
base_url = https://api.trackly.one/v1
api_key  = sk-aiagg-...
```

Оплата в рублях с единого баланса, российские карты, закрывающие документы —
без зарубежных карт и посредников.

## Создание API-ключа

1. Зарегистрируйся или войди в аккаунт.
2. Открой раздел [API-ключи](https://ai.trackly.one/account/api-keys) в личном кабинете.
3. Нажми «Создать ключ» и задай понятное имя (например, `my-app-dev`).
4. Скопируй ключ сразу: он показывается **один раз при создании**, дальше
   хранится только хеш.

> **Важно:** Ключ — это секрет. Не коммить его в git, не передавай в URL и не логируй. Если ключ засветился — отзови его в разделе API-ключей и создай новый.

## Первый запрос

Подставь свой ключ и выполни запрос к `chat.completions`:

**Первый запрос — chat.completions**

```bash
curl https://api.trackly.one/v1/chat/completions \
  -H "Authorization: Bearer $TRACKLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-haiku-4.5",
    "messages": [
      { "role": "user", "content": "Привет! Что ты умеешь?" }
    ]
  }'
```

```python
from openai import OpenAI

client = OpenAI(
    api_key="sk-aiagg-...",
    base_url="https://api.trackly.one/v1",
)

resp = client.chat.completions.create(
    model="anthropic/claude-haiku-4.5",
    messages=[{"role": "user", "content": "Привет! Что ты умеешь?"}],
)
print(resp.choices[0].message.content)
```

```javascript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-aiagg-...",
  baseURL: "https://api.trackly.one/v1",
});

const resp = await client.chat.completions.create({
  model: "anthropic/claude-haiku-4.5",
  messages: [{ role: "user", content: "Привет! Что ты умеешь?" }],
});
console.log(resp.choices[0].message.content);
```

В ответ придёт стандартный OpenAI-совместимый JSON: текст в
`choices[0].message.content`, расход токенов в `usage`. Стоимость запроса
списывается с баланса после завершения — по тарифу модели, актуальные цены
на странице [цен для разработчиков](https://ai.trackly.one/developers/pricing).

> Идентификатор модели — в формате `провайдер/модель`, например `anthropic/claude-haiku-4.5` или `openai/gpt-5`. Полный список отдаёт `GET /v1/models`, витрина с описаниями — в [каталоге моделей](https://ai.trackly.one/developers/models).

## Куда дальше

- [Аутентификация](https://ai.trackly.one/developers/docs/authentication) — формат ключей,
  заголовок `Authorization`, безопасное хранение.
- [Текст и чат](https://ai.trackly.one/developers/docs/text) — стриминг, tools, response_format,
  vision.
- [Изображения](https://ai.trackly.one/developers/docs/images) — генерация и редактирование.
- [Видео](https://ai.trackly.one/developers/docs/video) — create → poll → скачивание результата.
- [Аудио](https://ai.trackly.one/developers/docs/audio) — озвучка текста (TTS).
- [Ошибки](https://ai.trackly.one/developers/docs/errors) — формат ошибок, коды, ретраи.
- [Модели](https://ai.trackly.one/developers/docs/models) — как читать `GET /v1/models` и выбирать
  модель под задачу.