Riferimento · Autenticazione

Autenticazione Photta API una chiave, un header

In sintesi

Invia la tua chiave come `Authorization: Bearer photta_live_xxx` su ogni chiamata alla Photta API. Le chiavi si creano nella dashboard, non hanno scope per endpoint e condividono un unico saldo di credits.

Ottieni una chiave API Leggi la documentazione

Autenticazione: Chiave Bearer
Limiti: 600 richieste/min
Elaborazione: asincrono, polling

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

Cosa si aspetta l'API

L'autenticazione in sintesi

Header: Authorization: Bearer photta_live_xxx
Prefisso chiave: photta_live_
Base URL: https://api.photta.app/api/v1
Dove vengono create le chiavi: https://ai.photta.app
Scope: Una sola chiave accede a ogni endpoint e a un unico saldo di credits

Verifica una chiave con una sola chiamata

L'endpoint account è gratuito, quindi è il modo sicuro per verificare che una chiave funzioni.

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

Gestione delle chiavi

Ruota in caso di sospetto
La documentazione è esplicita: ruota immediatamente una chiave se sospetti che sia stata compromessa. Genera prima la chiave sostitutiva, distribuiscila e poi dismetti quella vecchia.
Mantienila sul server
Una chiave che arriva a un browser è accessibile a chiunque apra la pagina. Chiama l'API dal tuo backend e passa i risultati al client.
401 riguarda la chiave, non la richiesta
Una chiave mancante, non valida o scaduta restituisce `authentication_error`. Controlla l'header per eventuali errori di battitura e spazi vuoti prima di cercare altrove.
Un unico saldo dietro a ogni chiave
Le chiavi non hanno uno scope per funzionalità. Più chiavi per ambienti diversi attingono comunque allo stesso saldo di credits, restituito da GET `/api/v1/account`.

Domande sull'autenticazione

Come autentico una richiesta?

Invia la chiave nell'header Authorization come bearer token a ogni chiamata. Non esiste un passaggio separato di login o token-exchange.

Dove creo una chiave?

Nella tua dashboard Photta. La stessa posizione emette sostituzioni, che è ciò a cui punta la documentazione dopo un 401.

Posso chiamare l'API dal browser?

Non con la tua chiave. Tutto ciò che viene inviato a un browser è leggibile dai suoi visitatori, quindi inserisci la chiamata dietro al tuo server e inoltra il risultato.

Cosa succede se una chiave viene compromessa?

Fai subito una rotazione — genera una nuova chiave, distribuiscila, quindi elimina quella vecchia. I credits già spesi non possono essere recuperati, quindi prima ruota la chiave e poi indaga.

Endpoint e riferimenti

Ogni dato in questa pagina proviene da la documentazione dell'API di Photta · verificato 2026-09-10

Prova l'API in 5 minuti

Genera una chiave API di Photta, incolla lo snippet cURL qui sopra e otterrai la tua prima immagine con modello prima ancora che il caffè sia pronto.

Crea un account e ottieni una chiave API API

Chiave Bearer
600 richieste/min
asincrono, polling