Referens · Autentisering

Photta API-autentisering en nyckel, en header

I en mening

Skicka din nyckel som `Authorization: Bearer photta_live_xxx` vid varje anrop till Photta API. Nycklar skapas i kontrollpanelen, har inget omfång per endpoint och delar på samma saldo av credits.

  • Autentisering: Bearer-nyckel
  • Gränser: 600 requests/min
  • Bearbetning: asynkron, polling

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Vad API:et förväntar sig

Autentisering i korthet

Header
Authorization: Bearer photta_live_xxx
Nyckelprefix
photta_live_
Bas-URL
https://api.photta.app/api/v1
Var nycklar skapas
https://ai.photta.app
Omfång
En nyckel når varje endpoint och ett gemensamt saldo av credits

Validera en nyckel med ett anrop

Konto-endpointen är gratis, så det är det säkra sättet att bekräfta att en nyckel fungerar.

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

Hantera nycklar

  • Rotera vid misstanke

    Dokumentationen är tydlig: rotera en nyckel omedelbart om du misstänker att den har komprometterats. Generera ersättaren först, distribuera den, och avaktivera sedan den gamla.

  • Håll den på servern

    En nyckel som når en webbläsare når alla som öppnar sidan. Anropa API:et från din backend och skicka resultaten vidare till klienten.

  • 401 beror på nyckeln, inte anropet

    En saknad, ogiltig eller utgången nyckel returnerar `authentication_error`. Kontrollera headern efter stavfel och oönskade blanksteg innan du letar någon annanstans.

  • Ett saldo bakom varje nyckel

    Nycklar har inte begränsat omfång per funktion. Flera nycklar för flera miljöer förbrukar fortfarande samma saldo av credits, vilket GET `/api/v1/account` rapporterar.

Frågor om autentisering

Hur autentiserar jag en förfrågan?

Skicka nyckeln i Authorization-headern som en bearer-token vid varje anrop. Det finns inget separat inloggnings- eller tokenutbytessteg.

Var skapar jag en nyckel?

I din Photta-dashboard. Samma ställe utfärdar ersättningsnycklar, vilket är vad dokumentationen hänvisar till efter en 401.

Kan jag anropa API:et från webbläsaren?

Inte med din nyckel. Allt som skickas till en webbläsare kan läsas av dess besökare, så lägg anropet bakom din egen server och vidarebefordra resultatet.

Vad händer om en nyckel läcker?

Rotera den omedelbart — generera en ny nyckel, driftsätt den och ta sedan bort den gamla. Förbrukade credits kan inte återfås, så rotera först och undersök efteråt.

Endpoints och referenser

Varje siffra på den här sidan kommer från Photter API-dokumentationen · kontrollerad

Testa API:et på fem minuter

Generera en Photta API-nyckel, klistra in cURL-kodfragmentet ovan, och du har din första bild på en modell innan kaffet har bryggts klart.

  • Bearer-nyckel
  • 600 requests/min
  • asynkron, polling