Referenz · Authentifizierung

Photta API-Authentifizierung Ein Key, ein Header

In aller Kürze

Senden Sie Ihren Key bei jedem Photta-API-Aufruf als `Authorization: Bearer photta_live_xxx`. Keys werden im Dashboard erstellt, haben keine Scopes pro Endpoint und greifen auf dasselbe Credits-Guthaben zu.

API-Key anfordern Dokumentation lesen

Authentifizierung: Bearer-Key
Limits: 600 Anfragen/Min.
Verarbeitung: asynchron, Polling

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft 2026-09-10

Was die API erwartet

Authentifizierung im Überblick

Header: Authorization: Bearer photta_live_xxx
Key-Präfix: photta_live_
Base-URL: https://api.photta.app/api/v1
Wo Keys erstellt werden: https://ai.photta.app
Scope: Ein Key für alle Endpoints und ein gemeinsames Credits-Guthaben

Einen Key mit einem Aufruf prüfen

Der Account-Endpoint ist kostenlos – der sicherste Weg, um zu validieren, ob ein Key funktioniert.

curl https://api.photta.app/api/v1/account \
  -H "Authorization: Bearer $PHOTTA_API_KEY"

const res = await fetch("https://api.photta.app/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PHOTTA_API_KEY}` },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.photta.app/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PHOTTA_API_KEY']}"},
)
data = res.json()["data"]

Umgang mit Keys

Bei Verdacht rotieren
Die Dokumentation ist eindeutig: Rotieren Sie einen Key sofort, wenn der Verdacht besteht, dass er kompromittiert wurde. Erzeugen Sie zuerst das Replacement, deployen Sie es und invalidieren Sie erst danach den alten Key.
Auf dem Server behalten
Ein Key, der im Browser landet, ist für jeden sichtbar, der die Seite aufruft. Rufen Sie die API aus Ihrem Backend auf und leiten Sie die Ergebnisse an den Client weiter.
401 betrifft den Key, nicht den Request
Ein fehlender, ungültiger oder abgelaufener Key liefert `authentication_error`. Prüfen Sie den Header auf Tippfehler und überflüssige Leerzeichen, bevor Sie an anderer Stelle suchen.
Ein Guthaben für alle Keys
Keys sind nicht nach Capability beschränkt. Mehrere Keys für unterschiedliche Umgebungen verbrauchen dasselbe Credits-Guthaben, das über GET `/api/v1/account` abgefragt werden kann.

Fragen zur Authentifizierung

Wie authentifiziere ich einen Request?

Senden Sie den Key bei jedem Aufruf im Authorization-Header als Bearer-Token mit. Es gibt keinen separaten Login- oder Token-Exchange-Schritt.

Wo erstelle ich einen Key?

In Ihrem Photta-Dashboard. An derselben Stelle werden auch Ersatz-Keys ausgestellt, worauf die Dokumentation nach einem 401 verweist.

Kann ich die API aus dem Browser aufrufen?

Nicht mit Ihrem Key. Alles, was an einen Browser ausgeliefert wird, ist für dessen Besucher lesbar. Führen Sie den Aufruf daher über Ihren eigenen Server aus und leiten Sie das Ergebnis weiter.

Was passiert, wenn ein Key leakt?

Rotieren Sie ihn sofort — neuen Key generieren, deployen, dann den alten löschen. Bereits verbrauchte Credits können nicht erstattet werden; rotieren Sie also zuerst und analysieren Sie den Vorfall danach.

Endpoints und Referenzen

Jeder Zahlenwert auf dieser Seite stammt aus der Photta-API-Dokumentation · geprüft 2026-09-10

Testen Sie die API in fünf Minuten

Generieren Sie einen Photta-API-Schlüssel, fügen Sie das obige cURL-Snippet ein, und Sie erhalten Ihr erstes Bild am Model, noch bevor der Kaffee fertig gebrüht ist.

Konto erstellen und API-Key anfordern API

Bearer-Key
600 Anfragen/Min.
asynchron, Polling