# Authentifizierung

> Erfahren Sie, wie Sie Ihre API-Anfragen authentifizieren.

## Authentifizierung

Alle API-Anfragen müssen einen gültigen API-Schlüssel im `Authorization`-Header mit dem Bearer-Token-Schema sowie den `x-wayinvideo-api-version`-Header enthalten:

```
Authorization: Bearer YOUR_API_KEY
x-wayinvideo-api-version: v2
```

## API-Schlüssel erhalten

1. Melden Sie sich bei Ihrem [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) an
2. Klicken Sie auf **Create API Key**, um einen neuen Schlüssel zu generieren
3. Kopieren und speichern Sie Ihren API-Schlüssel sicher — er wird nur einmal angezeigt

> **Wichtig:** Halten Sie Ihren API-Schlüssel geheim. Geben Sie ihn niemals in clientseitigem Code oder öffentlichen Repositories preis. Wenn Sie vermuten, dass ein Schlüssel kompromittiert wurde, löschen Sie ihn sofort und erstellen Sie einen neuen.

## Authentifizierte Anfragen stellen

Fügen Sie den `Authorization`-Header in jede Anfrage ein:

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -d '{"video_url": "https://www.youtube.com/watch?v=example"}'
```

## Fehlerantworten

Bei fehlgeschlagener Authentifizierung gibt die API **403 Forbidden** zurück:

```json
{
  "timestamp": "2026-03-13T07:58:46.156+00:00",
  "status": 403,
  "error": "Forbidden",
  "path": "/api/v2/clips"
}
```