---
title: Szybki start | RunAPI
description: Twórz standardowe klucze API i zarządzaj nimi oraz stosuj mechanizmy
  zabezpieczające przy użyciu klucza zarządzającego RunAPI.
url: https://runapi.ai/pl/docs/guides/platform-management/quickstart.md
canonical: https://runapi.ai/pl/docs/guides/platform-management/quickstart
locale: pl
---

> Wersja HTML: https://runapi.ai/pl/docs/guides/platform-management/quickstart
> Indeks witryny dla agentów: https://runapi.ai/llms.txt

# Szybki start

Zarządzanie platformą umożliwia administratorom kont tworzenie, przeglądanie, aktualizowanie
i unieważnianie standardowych kluczy API oraz zabezpieczeń bez konieczności korzystania z panelu
podczas każdej zmiany.

## Tworzenie klucza zarządzania

Postępuj zgodnie z [Przewodnikiem po uwierzytelnianiu](https://runapi.ai/pl/docs/guides/authentication.md), aby się zalogować,
a następnie otwórz stronę Kluczy zarządzających i utwórz klucz zarządzający.
Przechowuj go oddzielnie od standardowych kluczy aplikacji. Wysyłaj go jako token Bearer
wyłącznie do endpointów zarządzania platformą.

```http
Authorization: Bearer YOUR_MANAGEMENT_KEY
```

Standardowy klucz API nie może wywoływać punktów końcowych zarządzania kluczami
ani barierami ochronnymi. Prawidłowy klucz zarządzający może nadal otrzymywać
odpowiedź `403 Forbidden`, gdy jego właściciel nie posiada już wymaganej roli
na koncie.

## Wyświetl listę standardowych kluczy API

Użyj `GET /api/v1/keys`, aby sprawdzić klucze widoczne dla konta klucza zarządzającego:

```shell
curl "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY"
```

Używaj zwróconych publicznych identyfikatorów do późniejszych żądań pobrania, aktualizacji, odwołania lub przypisania guardrail. Nigdy nie wywnioskuj dostępu na podstawie nazwy klucza ani zamaskowanego tokenu.

## Utwórz i rotuj klucz

Utwórz klucz aplikacji za pomocą `POST /api/v1/keys`. Pełny tajny klucz jest
zwracany tylko w odpowiedzi na tworzenie, więc zapisz go w swoim menedżerze tajnych kluczy
przed odrzuceniem tej odpowiedzi. Rotacja powinna polegać na utworzeniu zamiennika, wdrożeniu go
w aplikacji, weryfikacji ruchu, a następnie unieważnieniu starego klucza.

```shell
curl -X POST "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production worker"}'
```

`credit_limit_windows` akceptuje dowolną kombinację `1h`, `1d` i `7d`
kroczących limitów wydatków. Jeśli jakiekolwiek skonfigurowane okno zostanie wyczerpane, wywołania z
tym kluczem zwracają `429 Too Many Requests` do czasu, gdy użycie opuści okno.
Wyślij pusty obiekt podczas aktualizowania klucza, aby wyczyścić wszystkie kroczące limity.

## Zastosuj bariery ochronne (guardrails)

Guardrails to wielokrotnego użytku zasady konta dotyczące kontroli modelu, dostawcy i
wydatków. Zarządzaj zasadami za pomocą `/api/v1/guardrails`, a następnie
używaj `/api/v1/guardrail_assignments` do ich dołączania lub usuwania. Traktuj
odrzucone przypisanie jako błąd zasad lub własności zamiast po cichu
kontynuować bez guardrail.

## Obsługa błędów zarządzania

* `401 Unauthorized` oznacza, że poświadczenie jest brakujące, nieprawidłowo sformułowane,
  unieważnione lub nieważne.
* `403 Forbidden` oznacza, że klasa poświadczeń lub rola konta nie pozwala na
  wykonanie tej operacji.
* `404 Not Found` oznacza, że żądany zasób nie jest widoczny dla uwierzytelnionego konta.
* `422 Unprocessable Content` oznacza, że co najmniej jedna z przesłanych wartości
  narusza regułę zasobu.

---

## Więcej od RunAPI

- [Strona główna](https://runapi.ai/pl/.md)
- [Katalog modeli](https://runapi.ai/pl/models.md)
- [Cennik](https://runapi.ai/pl/pricing.md)
- [Dostawcy](https://runapi.ai/pl/models)
- [Dokumentacja](https://runapi.ai/pl/docs/guides)
- [SDK](https://runapi.ai/pl/sdk.md)
- [CLI](https://runapi.ai/pl/cli.md)
- [Serwer MCP](https://runapi.ai/pl/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/pl/claude-code-vs-cursor.md)
- [Konfiguracja Cursor API](https://runapi.ai/pl/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pl/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/pl/contact.md)
- [Kontakt](https://runapi.ai/pl/contact.md)
- [Regulamin](https://runapi.ai/pl/terms.md)
- [Prywatność](https://runapi.ai/pl/privacy.md)
- [Indeks witryny dla agentów](https://runapi.ai/llms.txt)

Kontakt: contact@runapi.ai

## Dane strukturalne

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pl",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pl",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pl/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pl",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pl",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/plicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pl",
    "@type": "TechArticle",
    "headline": "Szybki start",
    "description": "Twórz standardowe klucze API i zarządzaj nimi oraz stosuj mechanizmy zabezpieczające przy użyciu klucza zarządzającego RunAPI.",
    "url": "https://runapi.ai/pl/docs/guides/platform-management/quickstart",
    "mainEntityOfPage": "https://runapi.ai/pl/docs/guides/platform-management/quickstart"
  }
]
```