> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/setting-up-agent/svoi-klyuch-openai.md).

# Свои API-ключи

<a href="https://app.nextbot.ru/option#custom-api-key" class="button secondary">Перейти к блоку «Свой API-key»</a>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fb1bkCqgJzCVSQHSNs2lQ%2Fimage.png?alt=media&amp;token=6cc1a4c6-a518-4b45-9738-57cc27635a6b" alt=""><figcaption></figcaption></figure>

По умолчанию для работы ИИ-агента используются API-ключи LLM-провайдеров от Nextbot.\
\
Таким образом, пользователям сервиса не нужно создавать личные аккаунты LLM-провайдеров и отдельно настраивать оплату.\
При необходимости вы можете подключить собственные API-ключи и оплачивать расходы напрямую у выбранного провайдера.

Сейчас доступны ключи следующих провайдеров:

* **OpenAI** — для моделей OpenAI.
* **Anthropic** — для моделей Claude.
* **xAI** — для моделей Grok.
* **DeepSeek** — для моделей DeepSeek.
* **OpenRouter** — для подключения моделей через OpenRouter.

При добавлении своего ключа расходы у LLM-провайдера оплачиваете вы, а каждый запрос к LLM будет снимать 0.01 BotCoin с вашего Nextbot счёта.

{% hint style="warning" %}
**Ключи вводить НЕ ОБЯЗАТЕЛЬНО.**

В этом случае оплата будет происходить через BotCoin с аккаунта Nextbot.
{% endhint %}

#### **Как добавить:**

Нажмите кнопку ДОБАВИТЬ КЛЮЧ, выберите провайдера, введите ключ и нажмите СОХРАНИТЬ после проверки.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-234240d64edbf4eacce75af5b4eed8b6d3e995b7%2Fapi-key-providers.png?alt=media" alt="Выбор провайдера при добавлении API-ключа"><figcaption><p>Окно выбора провайдера API-ключа</p></figcaption></figure>

#### **Кеширование промпта для Anthropic**

Настройка есть только у своего ключа Anthropic: в окне ввода ключа и под таблицей ключей. У остальных провайдеров её нет. По умолчанию выбрано «Не кешировать».

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgit-blob-5fab821524b77b0ef330a2ca04ccb0b6520bf43b%2Fanthropic-keshirovanie-prompta.png?alt=media" alt="Окно API-ключа Anthropic с настройкой кеширования промпта"><figcaption><p>Кеширование промпта в окне ключа Anthropic: срок 5 минут или 1 час</p></figcaption></figure>

Кешируются системный промпт и функции агента. Повторный запрос читает их из кеша вместо полной оплаты входа. Текущая дата и фрагменты базы знаний в кеш не входят и не сбрасывают его.

Запись в кеш дороже обычных входных токенов: в 1,25 раза при сроке 5 минут и в 2 раза при сроке 1 час. Чтение из кеша примерно в 10 раз дешевле. Списание Nextbot при своём ключе не меняется — по-прежнему 0.01 BotCoin за запрос. Меняется счёт у Anthropic.

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

Кеш срабатывает, только если промпт вместе с функциями не короче минимума модели. Более короткий промпт Anthropic не кеширует, ошибки при этом нет. 1000 токенов — это около 2500 знаков русского текста.

| Модель                                              | Минимум, токенов |
| --------------------------------------------------- | ---------------- |
| Claude Opus 5, Claude Fable 5, Claude Fable 5.1     | 512              |
| Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8 | 1024             |
| Claude Opus 4.7                                     | 2048             |
| Claude Haiku 4.5, Claude Opus 4.6                   | 4096             |

Кеш начинается заново, если изменить текст промпта или сменить модель. Если в промпте есть переменные, у каждого диалога свой кеш.

{% hint style="info" %}
Если вместе с ключом Anthropic добавлен ключ OpenRouter, кеширование недоступно: запросы идут через OpenRouter. Селект становится неактивным.
{% endhint %}

#### **Особенность для OpenAI**

{% hint style="warning" %}
**Для стабильной работы моделей OpenAI нужен минимум 3 уровень Usage tier.** Посмотреть свой уровень можно по [ссылке](https://platform.openai.com/settings/organization/limits).

В OpenAI уровень Usage tier повышается автоматически по мере оплат и трат на API. На текущий момент для 3 уровня OpenAI указывает условие: оплачено от $100 и прошло не менее 7 дней с момента первого успешного платежа.
{% endhint %}

#### **Почему важен уровень ключа OpenAI?**

Представьте, что запросы встают в очередь на стороне LLM, и когда очередь переполняется, то ключи с самым низким уровнем отключаются, а GPT возвращает ошибку. Соответственно, чем ниже уровень ключа, тем выше вероятность ошибки.\
По [ссылке](https://platform.openai.com/docs/guides/rate-limits/usage-tiers?context=tier-one) перечислены требования к уровням ключа. Чем больше подтверждённые оплаты и фактические траты на API в OpenAI, тем выше ваш Usage tier и лимиты.\
Если вы оплачиваете OpenAI картой, списание происходит по факту потраченных средств. В зависимости от способа оплаты в вашем аккаунте OpenAI это может быть автоматическое списание с карты или списание из заранее пополненного баланса.

Для проверки состояния ключа нажмите кнопку **"проверить"**.

{% hint style="warning" %}
**Важно! После пополнения баланса в OpenAI, деньги поступают на счёт с небольшой задержкой, а значит некоторое время ключ может быть неактивным.**

**Подождите несколько минут и попробуйте заново.**
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.nextbot.ru/functional/setting-up-agent/svoi-klyuch-openai.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
