> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentinbox.space/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentinbox.space/_mcp/server.

# Как получить API-ключ?

Для запросов к API нужен ключ. Ключи начинаются с `am_` и создаются в консоли Agent Inbox.

## Шаги

1. Откройте [консоль Agent Inbox](https://agentinbox-ru.vercel.app/)
2. Зарегистрируйтесь или войдите
3. Раздел **API Keys** в боковом меню
4. **Create New API Key**
5. Укажите понятное имя (например `my-support-agent`)
6. Сразу скопируйте ключ и храните в безопасном месте

> **Warning**
>
> Ключ показывается только один раз. При потере создайте новый. Не коммитьте ключи в репозиторий и не публикуйте их.

## Использование ключа

Храните ключ в переменной окружения:

**`Bash`**

```bash title="Bash"
# .env file
AGENTINBOX_API_KEY=am_your_key_here
```

Инициализация SDK:

**`TypeScript`**

```typescript title="TypeScript"
import { AgentinboxClient } from "agentinbox";
import "dotenv/config";

const client = new AgentinboxClient({
  apiKey: process.env.AGENTINBOX_API_KEY,
});

// Test the connection by creating an inbox
const inbox = await client.inboxes.create();
console.log(`Connected! Created inbox: ${inbox.inboxId}`);
```

## Ограниченные по области ключи

Помимо ключей уровня организации можно создавать ключи для одного pod или одного ящика — доступ только к ресурсам в этой области.

* **Ключ pod:**`POST /pods/{pod_id}/api-keys` или `client.pods.api_keys.create()`
* **Ключ ящика:**`POST /inboxes/{inbox_id}/api-keys` или `client.inboxes.api_keys.create()`

Подробнее — [Мультитенантность](/multi-tenancy#scoped-api-keys).

##