Referentie · Authenticatie

Photta API-authenticatie één key, één header

In één zin

Stuur je key mee als `Authorization: Bearer photta_live_xxx` bij elke Photta API-call. Keys worden aangemaakt in het dashboard, hebben geen scope per endpoint en delen één credits-saldo.

API-sleutel ophalen Lees de documentatie

Authenticatie: Bearer key
Limieten: 600 requests/min
Verwerking: async, polling

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

Wat de API verwacht

Authenticatie in één oogopslag

Header: Authorization: Bearer photta_live_xxx
Key-voorvoegsel: photta_live_
Basis-URL: https://api.photta.app/api/v1
Waar keys worden aangemaakt: https://ai.photta.app
Scope: Eén key geeft toegang tot elk endpoint en één credits-saldo

Controleer een key in één call

Het account-endpoint is gratis, dus het is de veilige manier om te controleren of een key werkt.

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"]

Omgaan met keys

Roteer bij twijfel
De documentatie is expliciet: roteer een key direct als je vermoedt dat deze gecompromitteerd is. Genereer eerst de vervanger, implementeer deze en trek pas daarna de oude in.
Houd het op de server
Een key die in de browser terechtkomt, is zichtbaar voor iedereen die de pagina opent. Roep de API aan vanuit je backend en stuur de resultaten door naar de client.
401 duidt op de key, niet op het request
Een ontbrekende, ongeldige of verlopen key retourneert `authentication_error`. Controleer de header op typefouten en overbodige spaties voordat je ergens anders zoekt.
Eén saldo voor elke key
Keys zijn niet scoped per functionaliteit. Meerdere keys voor verschillende omgevingen verbruiken nog steeds hetzelfde credits-saldo, dat via GET `/api/v1/account` wordt gerapporteerd.

Vragen over authenticatie

Hoe authenticeer ik een request?

Stuur de sleutel bij elke aanroep mee in de Authorization-header als bearer-token. Er is geen aparte inlog- of token-exchange-stap.

Waar maak ik een sleutel aan?

In je Photta-dashboard. Op dezelfde plek worden vervangende sleutels uitgegeven; daar verwijst de documentatie je ook naar na een 401.

Kan ik de API aanroepen vanuit de browser?

Niet met je sleutel. Alles wat naar een browser wordt verzonden is leesbaar voor bezoekers, dus plaats de aanroep achter je eigen server en stuur het resultaat door.

Wat als een sleutel lekt?

Roteer deze direct — genereer een nieuwe sleutel, implementeer deze en verwijder vervolgens de oude. Reeds verbruikte credits kunnen niet worden teruggevorderd, dus roteer eerst en onderzoek pas daarna.

Endpoints en referenties

Elk getal op deze pagina is afkomstig uit de Photta-API-documentatie · gecontroleerd 2026-09-10

Probeer de API in vijf minuten

Genereer een Photta API-sleutel, plak het bovenstaande cURL-fragment en je hebt je eerste afbeelding op een model voordat de koffie klaar is.

Maak een account aan en haal een API-sleutel op API

Bearer key
600 requests/min
async, polling