Deployment API

Pilotez un Digital Human par API.

L’API de déploiement permet d’envoyer une conversation à un avatar précis avec une clé révocable créée depuis son espace de déploiement.

Authentification

Utilisez Authorization: Bearer avec la clé générée pour l’avatar. La clé en clair n’est affichée qu’une seule fois à sa création.

Sécurité

Chaque clé est liée à un propriétaire et un avatar, stockée sous forme hachée, révocable et soumise aux quotas du plan.

Endpoint

POST /api/v1/avatar/chat avec 1 à 50 messages user/assistant, 8 000 caractères maximum par message.

Exemple de requête

curl -X POST "$BASE_URL/api/v1/avatar/chat" \
  -H "Authorization: Bearer nh_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Bonjour, peux-tu m'aider ?" }
    ]
  }'

Réponse

{
  "id": "…",
  "object": "nexushuman.chat.completion",
  "avatarId": "…",
  "model": "google/gemini-3-flash-preview",
  "reply": "…"
}

Comportement

Les clés révoquées sont refusées immédiatement.
L’accès API dépend du plan actif et de ses droits.
Le trafic est protégé par une limite distribuée de 120 requêtes par 10 minutes et par clé.
Lorsque des connaissances sont disponibles, le moteur RAG de l’avatar est injecté automatiquement dans le contexte.