Reference · Autentifikation

Photta API-autentifikation én nøgle, én header

I én sætning

Send din nøgle som `Authorization: Bearer photta_live_xxx` ved hvert Photta API-kald. Nøgler oprettes i kontrolpanelet, har ingen scopes pr. endpoint og deler én credits-saldo.

  • Autentifikation: Bearer key
  • Grænser: 600 requests/min
  • Behandling: async, polling

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket

Hvad API'et forventer

Autentifikation i korte træk

Header
Authorization: Bearer photta_live_xxx
Nøglepræfiks
photta_live_
Base-URL
https://api.photta.app/api/v1
Hvor nøgler oprettes
https://ai.photta.app
Scope
Én nøgle giver adgang til hvert endpoint og én credits-saldo

Tjek en nøgle med ét kald

Konto-endpointet er gratis, så det er den sikre måde at bekræfte, at en nøgle virker.

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

Håndtering af nøgler

  • Rotér ved mistanke

    Dokumentationen er tydelig: Rotér en nøgle med det samme, hvis du har mistanke om, at den er kompromitteret. Opret erstatningen først, udrul den, og træk derefter den gamle tilbage.

  • Behold den på serveren

    En nøgle, der når en browser, når alle, der åbner siden. Kald API'et fra din backend, og videresend resultaterne til klienten.

  • 401 gælder nøglen, ikke anmodningen

    En manglende, ugyldig eller udløbet nøgle returnerer `authentication_error`. Tjek headeren for slåfejl og overskydende mellemrum, før du leder andre steder.

  • Én saldo bag hver nøgle

    Nøgler er ikke afgrænset pr. funktionalitet. Flere nøgler til flere miljøer bruger stadig den samme credits-saldo, som GET `/api/v1/account` rapporterer.

Spørgsmål om autentifikation

Hvordan godkender jeg en anmodning?

Send nøglen i Authorization-headeren som et bearer token på hvert kald. Der er intet separat login- eller token-exchange-trin.

Hvor opretter jeg en nøgle?

I dit Photta-dashboard. Samme sted udsteder erstatninger, hvilket er det, dokumentationen henviser til efter en 401.

Kan jeg kalde API'et fra browseren?

Ikke med din nøgle. Alt, der sendes til en browser, kan læses af dens besøgende, så læg kaldet bag din egen server og videresend resultatet.

Hvad hvis en nøgle bliver lækket?

Roter den med det samme — generer en ny nøgle, udrul den, og slet derefter den gamle. Credits, der allerede er brugt, kan ikke gendannes, så roter først og undersøg bagefter.

Endpoints og referencer

Hvert tal på denne side stammer fra Photta API-dokumentationen · tjekket

Prøv API'et på fem minutter

Generér en Photta API-nøgle, indsæt cURL-kodestykket ovenfor, og du har dit første billede på en model, før kaffen er færdigbrygget.

  • Bearer key
  • 600 requests/min
  • async, polling