Referanse · Autentisering

Photta API-autentisering én nøkkel, én header

I én setning

Send nøkkelen din som `Authorization: Bearer photta_live_xxx` i hvert Photta API-kall. Nøkler opprettes i dashbordet, har ingen scopes per endpoint, og deler én kredittsaldo.

  • Autentisering: Bearer-nøkkel
  • Grenser: 600 forespørsler/min
  • Prosessering: asynkron, polling

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert

Hva API-et forventer

Autentisering i et nøtteskall

Header
Authorization: Bearer photta_live_xxx
Nøkkelprefiks
photta_live_
Base-URL
https://api.photta.app/api/v1
Hvor nøkler opprettes
https://ai.photta.app
Scope
Én nøkkel når hvert endpoint og én felles kredittsaldo

Verifiser en nøkkel i ett kall

Konto-endpointet er gratis, så det er den trygge måten å bekrefte at en nøkkel fungerer på.

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

Håndtering av nøkler

  • Roter ved mistanke

    Dokumentasjonen er tydelig: roter en nøkkel umiddelbart hvis du mistenker at den er kompromittert. Generer erstatningen først, distribuer den, og trekk deretter tilbake den gamle.

  • Hold den på serveren

    En nøkkel som når en nettleser, når alle som åpner siden. Gjør API-kall fra backend og videresend resultatene til klienten.

  • 401 gjelder nøkkelen, ikke forespørselen

    En manglende, ugyldig eller utløpt nøkkel returnerer `authentication_error`. Sjekk headeren for skrivefeil og ekstra mellomrom før du feilsøker noe annet.

  • Én saldo bak hver nøkkel

    Nøkler har ikke scope per funksjon. Flere nøkler for ulike miljøer bruker likevel fra samme kredittsaldo, som rapporteres av GET `/api/v1/account`.

Spørsmål om autentisering

Hvordan autentiserer jeg en forespørsel?

Send nøkkelen i Authorization-headeren som et bearer-token ved hvert kall. Det finnes ingen separat innlogging eller tokenutveksling.

Hvor oppretter jeg en nøkkel?

I Photta-dashbordet ditt. Samme sted utsteder erstatningsnøkler, som er det dokumentasjonen henviser deg til etter en 401.

Kan jeg kalle API-et fra nettleseren?

Ikke med nøkkelen din. Alt som sendes til en nettleser kan leses av brukerne, så legg kallet bak din egen server og videresend resultatet.

Hva om en nøkkel lekker?

Roter den umiddelbart — generer en ny nøkkel, rull den ut, og slett deretter den gamle. Credits som allerede er brukt kan ikke refunderes, så roter først og undersøk etterpå.

Endpoints og referanser

Hvert tall på denne siden er hentet fra dokumentasjonen for Photta-API-et · verifisert

Prøv API-et på fem minutter

Generer en Photta API-nøkkel, lim inn cURL-kodesnutten ovenfor, og du har ditt første bilde på modell før kaffen er ferdig traktet.

  • Bearer-nøkkel
  • 600 forespørsler/min
  • asynkron, polling