Prismatic API/Docs/Authentification
Documentation

Authentification

La plupart des endpoints publics nécessitent une clé API Prismatic. Les clients style OpenAI utilisent Authorization: Bearer; les clients style Anthropic peuvent utiliser x-api-key plus anthropic-version.

Header standard

Utilise ce header pour les endpoints compatibles OpenAI et pour les clients HTTP directs qui attendent une authentification bearer.

Bash
Authorization: Bearer pa_YOUR_KEY

Header compatible Anthropic

Utilise ce set de headers pour POST /v1/messages et POST /v1/messages/count_tokens quand ton client parle le protocole Anthropic.

Bash
x-api-key: pa_YOUR_KEY
anthropic-version: 2023-06-01

Où récupérer la clé

Ouvre le dashboard Prismatic, va dans Clés API et génère une clé API client. Garde la clé complète secrète ; seul le préfixe peut être affiché dans les logs ou l’UI.

Bonnes pratiques

  • Garde les clés côté serveur quand c’est possible.
  • Régénère immédiatement une clé si un client, screenshot ou dépôt l’expose.
  • Utilise une clé par environnement ou intégration quand c’est pratique.
  • Traite les erreurs 401 séparément des erreurs 402 billing et 429 rate limit.