API-Schlüssel

Persönliche Zugriffstoken (PATs) ermöglichen es dir, dich aus externen Tools und Code bei der Pipe2.ai-API und dem MCP-Server zu authentifizieren.

Ein Token erstellen

Gehe zu pipe2.ai/api-keys
Klicke auf Token erstellen Mit MCP-Clients:
Kopiere das Token — es wird nur einmal angezeigt

Dein Token verwenden

Mit SDKs:

import { createClient } from '@pipe2-ai/sdk';
const client = createClient('YOUR_TOKEN');

Mit MCP-Clients:

{
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}

Mit rohem GraphQL:

curl -X POST https://api.pipe2.ai/v1/graphql \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ pipelines { name } }"}'

Ein Token widerrufen

Klicke auf die Widerrufen-Schaltfläche neben einem Token. Der Widerruf wird innerhalb von 30 Sekunden wirksam. Das Token funktioniert dann für alle Clients nicht mehr, die es verwenden.

Schlüsselkontrollen

Du kannst bis zu 25 aktive Schlüssel pro Konto haben. Widerrufene und abgelaufene Schlüssel geben einen Platz frei. Lege einen Namen, optional erlaubte Pipelines, ein Credit-Limit, einen Rücksetzzeitraum (keinen, täglich, wöchentlich, monatlich oder jährlich) und eine Gültigkeit (1, 7, 30, 90 oder 365 Tage) fest. Die Zeiträume folgen dem UTC-Kalender; Wochen beginnen am Montag. Ohne Credit-Limit kann der Schlüssel die verfügbaren Credits deines Kontos nutzen.

Mit pipelines:run kann ein Schlüssel jede Pipeline ausführen. Für bestimmte Pipelines füge je ein Recht pipeline:run:SLUG hinzu; mehrere sind möglich. API- und MCP-Anfragen verwenden nur die gewählten Berechtigungen. Berechtigungen und Pipeline-Auswahl stehen bei der Erstellung fest; widerrufe den Schlüssel und erstelle einen neuen, um sie zu ändern. Bewahre Schlüssel für externe Anwendungen auf deinem Server auf.

Läufe werden blockiert, wenn ihre Reservierung das verbleibende Schlüssellimit überschreitet. Tatsächlich berechnete Credits erscheinen nach der Abrechnung; Erstattungen geben die Reservierung frei.

mutation {
  create_personal_access_token(
    name: "My application"
    scopes: ["pipeline:run:YOUR_PIPELINE_SLUG", "pipeline:run:ANOTHER_PIPELINE_SLUG"]
    credit_limit: 100
    reset_period: "daily"
    expires_in_days: 90
  ) { token expires_at }
}