Documentation TechNova AI

Démarrage rapide

Créez un compte, rechargez vos crédits Technova (Mobile Money ou carte), générez une clé API dans votre tableau de bord, rubrique API, puis envoyez votre première requête depuis votre serveur.

curl https://votre-domaine-technova/api/ai/chat \
  -H "Authorization: Bearer $TECHNOVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Gemini 2.5 Flash",
    "messages": [{ "role": "user", "content": "Bonjour Technova" }]
  }'

Authentification

Chaque appel se fait avec un jeton porteur. Une clé appartient à un seul compte et consomme les crédits de ce compte. Elle n'est affichée qu'une seule fois, à sa création : conservez-la dans une variable d'environnement. Ne l'exposez jamais dans un navigateur ou une application mobile : appelez l'API depuis votre serveur.

En cas de fuite, supprimez la clé depuis le tableau de bord et créez-en une nouvelle.

Authorization: Bearer tn_live_xxxxxxxxxxxxxxxx

Chat completions

Un seul point d'entrée, POST /api/ai/chat, pour tous les modèles de texte. Champs acceptés : model, messages (rôles system, user et assistant, 60 messages au plus), max_tokens (1 à 4 096), temperature (0 à 2) et idempotency_key.

La réponse suit le format chat.completion : le texte généré dans choices[0].message.content et, dans usage, les tokens consommés ainsi que les crédits exacts débités. Répéter la même idempotency_key renvoie la réponse d'origine sans facturer une seconde fois. Les réponses sont renvoyées en une fois (pas de streaming).

POST /api/ai/chat
{
  "model": "Claude Sonnet 5",
  "messages": [
    { "role": "system", "content": "Tu es un assistant commercial." },
    { "role": "user", "content": "Rédige une relance client." }
  ],
  "temperature": 0.7,
  "max_tokens": 800,
  "idempotency_key": "<uuid>"
}

→ 200
{
  "object": "chat.completion",
  "choices": [{ "message": { "role": "assistant", "content": "…" } }],
  "usage": { "prompt_tokens": 42, "completion_tokens": 180, "credits": 3 }
}

Modèles disponibles

Le champ model accepte le nom affiché sur la page Modèles, par exemple « GPT-4o Mini », « Claude Sonnet 5 », « Gemini 2.5 Flash » ou « DeepSeek V3 ». Un modèle inconnu renvoie l'erreur model_not_available avec la liste des modèles acceptés.

L'API couvre les modèles de texte et de code. Les images, vidéos et musiques se génèrent depuis l'interface TechNova.

Crédits & facturation

L'unité de facturation est le crédit Technova. Chaque réponse est facturée selon les tokens réellement consommés et le tarif du modèle ; une requête qui échoue ne coûte rien.

• 1 crédit ≈ 1 FCFA de valeur d'usage.
• Les crédits n'expirent pas et sont communs à toute la plateforme.
• Le détail de chaque requête est visible dans la rubrique Utilisation du tableau de bord, avec export CSV.

Codes d'erreur

Les erreurs sont renvoyées sous la forme { "error": { "code", "message" } }. Traitez-les explicitement.

• invalid_api_key (401) — clé absente ou invalide.
• insufficient_credits (402) — solde insuffisant, proposez une recharge.
• model_not_available (400) — modèle inconnu.
• invalid_request (400) — requête mal formée ; le message précise le champ en cause.
• rate_limited (429) — trop de requêtes, réessayez après une pause.
• upstream_error (502) — le modèle n'a pas pu répondre, aucun crédit n'est débité.

Limites

Par défaut : 60 requêtes par minute et par compte, 60 messages par requête, 40 000 caractères par message et 4 096 tokens de réponse au plus. Besoin de limites plus élevées ? Écrivez-nous.

Recharge des crédits

La recharge se fait depuis le tableau de bord, par Mobile Money (MTN, Moov, Orange Money, Wave) ou par carte bancaire, via notre partenaire de paiement sécurisé. Les crédits ne sont ajoutés qu'après la confirmation du paiement par ce partenaire, jamais depuis le navigateur.