Référence · Authentification

Authentification de l’API Photta une seule clé, un seul en-tête

En une phrase

Envoyez votre clé sous la forme `Authorization: Bearer photta_live_xxx` sur chaque appel à l’API Photta. Les clés sont créées dans le tableau de bord, ne portent aucun scope par endpoint et partagent un solde unique de crédits.

Obtenir une clé API Consulter la documentation

Authentification: Clé Bearer
Limites: 600 requêtes/min
Traitement: asynchrone, polling

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié 2026-09-10

Ce que l’API attend

L’authentification en un coup d’œil

En-tête: Authorization: Bearer photta_live_xxx
Préfixe de clé: photta_live_
URL de base: https://api.photta.app/api/v1
Où les clés sont créées: https://ai.photta.app
Scope: Une seule clé accède à chaque endpoint et à un solde unique de crédits

Vérifier une clé en un seul appel

L’endpoint account est gratuit, c’est donc le moyen sûr de confirmer qu’une clé fonctionne.

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

Gestion des clés

Effectuez une rotation au moindre doute
La documentation est explicite : effectuez immédiatement une rotation d’une clé si vous soupçonnez qu’elle est compromise. Générez d’abord la clé de remplacement, déployez-la, puis révoquez l’ancienne.
Conservez-la côté serveur
Une clé qui parvient à un navigateur est accessible à quiconque ouvre la page. Appelez l’API depuis votre backend et transmettez les résultats au client.
401 concerne la clé, pas la requête
Une clé manquante, invalide ou expirée renvoie `authentication_error`. Vérifiez l’en-tête pour repérer d’éventuelles fautes de frappe ou espaces superflus avant de chercher ailleurs.
Un seul solde derrière chaque clé
Les clés n’ont pas de scope par fonctionnalité. Plusieurs clés pour plusieurs environnements consomment toujours le même solde de crédits, renvoyé par GET `/api/v1/account`.

Questions sur l’authentification

Comment authentifier une requête ?

Envoyez la clé dans l'en-tête Authorization sous forme de bearer token à chaque appel. Il n'y a pas d'étape séparée de connexion ou d'échange de token.

Où créer une clé ?

Dans votre tableau de bord Photta. C'est au même endroit que sont générées les clés de remplacement, ce vers quoi la documentation vous renvoie après un 401.

Puis-je appeler l'API depuis le navigateur ?

Pas avec votre clé. Tout ce qui est envoyé à un navigateur peut être lu par ses visiteurs ; placez donc l'appel derrière votre propre serveur et transmettez le résultat.

Que faire si une clé fuite ?

Faites-la tourner immédiatement — générez une nouvelle clé, déployez-la, puis supprimez l'ancienne. Les crédits déjà consommés ne peuvent pas être récupérés, donc renouvelez d'abord et investiguez ensuite.

Endpoints et références

Chaque chiffre sur cette page provient de la documentation de l'API Photta · vérifié 2026-09-10

Testez l'API en cinq minutes

Générez une clé d'API Photta, collez le snippet cURL ci-dessus, et vous obtiendrez votre première photo portée sur modèle avant même que le café ait fini de couler.

Créer un compte et obtenir une clé API API

Clé Bearer
600 requêtes/min
asynchrone, polling