Documentation

curl

Utilise des requêtes HTTP brutes pour les smoke tests, scripts d’automatisation et intégrations serveur minimales.

Configuration

  • Exporte PRISMATIC_API_KEY dans ton shell avant d’envoyer les requêtes.
  • Utilise Authorization: Bearer $PRISMATIC_API_KEY pour les endpoints compatibles OpenAI.
  • Utilise x-api-key et anthropic-version pour /v1/messages et /v1/messages/count_tokens.
  • Ajoute Content-Type: application/json sur chaque requête POST.

Exemple

export PRISMATIC_API_KEY="pa_YOUR_KEY"
export PRISMATIC_BASE_URL="https://api.prismaticapi.com/v1"
curl https://api.prismaticapi.com/v1/chat/completions \
  -H "Authorization: Bearer $PRISMATIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      { "role": "system", "content": "You are a concise release assistant." },
      { "role": "user", "content": "Write three product taglines." }
    ],
    "stream": false,
    "max_tokens": 400
  }'
curl https://api.prismaticapi.com/v1/messages \
  -H "x-api-key: $PRISMATIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 400,
    "messages": [
      { "role": "user", "content": "Draft a deployment checklist." }
    ]
  }'

Modèles recommandés

  • claude-sonnet-4-6 — modèle fort pour raisonnement, refactor et agents de code.
  • claude-haiku-4-5 — option rapide pour autocomplete, petites questions et tâches légères.
  • deepseek-v3-2 ou autre ID public — alternative selon ton catalogue actif et ton plan.

Troubleshooting

Erreur d’authentification

Vérifie que la clé API ne contient pas d’espace en trop et qu’elle n’a pas été révoquée dans le dashboard.

Modèle refusé

Utilise un ID modèle public retourné par GET /v1/models ; n’utilise pas de label ou d’alias.

Problème de connexion

Confirme que la base URL configurée correspond exactement à celle indiquée et que ton réseau autorise HTTPS vers api.prismaticapi.com.

Notes

  • Utilise curl -N pour tester le streaming et afficher les chunks dès leur arrivée.
  • Une réponse 401 signifie que la clé API est manquante, révoquée ou invalide.
  • Une réponse 402 signifie que le quota ou le crédit PAYG bloque la requête.