> ## Documentation Index
> Fetch the complete documentation index at: https://www.krea.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API Keys & Billing

> Создавайте и управляйте API-ключами, пополняйте API-баланс и разбирайтесь в ценах по моделям, чтобы выпускать интеграции с Krea с предсказуемой стоимостью.

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

Создавать API-токены могут только **владельцы** и **администраторы** рабочего пространства. Если вы не видите кнопки создания токена, обратитесь к владельцу рабочего пространства, чтобы запросить доступ или повышенную роль.

Чтобы создать API-ключ:

1. Перейдите на [krea.ai/settings/api-tokens](https://www.krea.ai/settings/api-tokens)
2. Убедитесь, что вы находитесь в нужном рабочем пространстве (с помощью переключателя рабочих пространств в левом верхнем углу)
3. Нажмите «New Token»
4. Дайте токену понятное название
5. Сохраните токен в надёжном месте — он показывается только один раз!

<Info>
  API работает как отдельная пользовательская идентичность внутри вашего рабочего пространства. Стили, обученные в приложении, недоступны через API, а стили, обученные через API, не появляются в приложении, если только они не предоставлены рабочему пространству. Подробности см. в разделе [Обучение собственного стиля](/developers/tutorials/train-image-style#use-your-trained-style).
</Info>

<Warning>
  **Рекомендации по безопасности**

  * Храните токены в переменных окружения, а не в коде
  * Используйте разные токены для разработки и продакшена
  * Немедленно отзывайте токены при их компрометации
  * Никогда не отправляйте токены в систему контроля версий
  * Никогда не публикуйте токены в открытом доступе
</Warning>

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

Включайте свой токен в заголовок `Authorization` всех запросов:

<CodeGroup>
  ```javascript Node.js theme={null}
  // npm install @krea-ai/sdk
  import { Krea } from "@krea-ai/sdk";

  const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

  const job = await krea.image("bfl/flux-1-dev", {
    prompt: "a serene mountain landscape at sunset",
    width: 1024,
    height: 576
  });

  console.log(`Job ID: ${job.job_id}`);
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.krea.ai/generate/image/bfl/flux-1-dev \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "prompt": "a serene mountain landscape at sunset",
      "width": 1024,
      "height": 576
    }'
  ```

  ```python Python theme={null}
  import requests

  API_BASE = "https://api.krea.ai"
  API_TOKEN = "your-api-token"

  response = requests.post(
      f"{API_BASE}/generate/image/bfl/flux-1-dev",
      headers={
          "Authorization": f"Bearer {API_TOKEN}",
          "Content-Type": "application/json"
      },
      json={
          "prompt": "a serene mountain landscape at sunset",
          "width": 1024,
          "height": 576
      }
  )

  job = response.json()
  print(f"Job ID: {job['job_id']}")
  ```

  ```go Go theme={null}
  package main

  import (
      "bytes"
      "encoding/json"
      "fmt"
      "net/http"
  )

  func main() {
      apiBase := "https://api.krea.ai"
      apiToken := "your-api-token"

      payload := map[string]interface{}{
          "prompt": "a serene mountain landscape at sunset",
          "width":  1024,
          "height": 576,
      }

      jsonData, _ := json.Marshal(payload)
      req, _ := http.NewRequest("POST", apiBase+"/generate/image/bfl/flux-1-dev", bytes.NewBuffer(jsonData))
      req.Header.Set("Authorization", "Bearer "+apiToken)
      req.Header.Set("Content-Type", "application/json")

      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()

      var job map[string]interface{}
      json.NewDecoder(resp.Body).Decode(&job)
      fmt.Printf("Job ID: %s\n", job["job_id"])
  }
  ```
</CodeGroup>

## Цены

Цены по каждой модели смотрите на странице [krea.ai/features/api ↗](https://krea.ai/features/api). У каждой модели фиксированная стоимость одной генерации, определяемая параметрами вашего запроса (разрешение, качество, аудио, длительность, референсы стиля и т. д.).

## Как работает биллинг API

Прямые вызовы API и MCP-подключения, использующие API-токен, списываются с **отдельного USD-баланса** вашего рабочего пространства — независимо от compute-юнитов, используемых веб-приложением Krea. MCP-подключения через OAuth списываются с учётной записи Krea, в которую выполнен вход, и оплачиваются compute-юнитами. Перед использованием API-ключей в вашем рабочем пространстве должен быть включён доступ к API; если он не включён, обратитесь в [support@krea.ai ↗](mailto:support@krea.ai).

<Check>
  Неудачные и отменённые задачи не тарифицируются. Вы платите только за успешно завершённые задачи.
</Check>

### Когда баланс заканчивается

Уже запущенные задачи завершаются как обычно. Новые API-запросы отклоняются с ошибкой **HTTP 402 Payment Required**:

```json theme={null}
{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}
```

Чтобы продолжить работу, пополните баланс на [krea.ai/app/api/](https://krea.ai/app/api/). Публичного эндпоинта для программной проверки баланса нет — отслеживайте его в приложении.

## Пополнение API-баланса

Добавляйте средства на [krea.ai/app/api/](https://krea.ai/app/api/). Пополнять API-баланс могут только **владельцы** рабочего пространства.

* **Предустановленные суммы:** \$10, \$25, \$50, \$100
* **Произвольная сумма:** минимум \$5, максимум \$10,000
* Оплата через Stripe Checkout; баланс пополняется сразу после успешной оплаты

## Отслеживание расходов

Недавние траты отображаются в карточке API-баланса на странице [krea.ai/app/api/](https://krea.ai/app/api/) в разделе «API cost in the last 7 days».

## Корпоративным клиентам

<Info>
  Клиентам с большими объёмами доступна ежемесячная оплата по счетам с условиями Net 30 вместо предоплаты. Обсудить корпоративный биллинг можно по адресу [sales@krea.ai ↗](mailto:sales@krea.ai).
</Info>

## Дальнейшие шаги

<CardGroup cols={2}>
  <Card title="Интерактивная песочница" icon="rocket" href="/developers/interactiveexample">
    Сделайте свой первый API-запрос
  </Card>

  <Card title="API моделей" icon="book-open" href="/api-reference/image/flux">
    Изучите все доступные эндпоинты
  </Card>

  <Card title="Жизненный цикл задачи" icon="cube" href="/developers/job-lifecycle">
    Разберитесь в состояниях задач и опросе их статуса
  </Card>

  <Card title="Ограничения по частоте" icon="gauge" href="/developers/rate-limits">
    Узнайте об API-лимитах в зависимости от тарифа
  </Card>
</CardGroup>
