Aller au contenu principal

Questions fréquemment posées (FAQ)

Trouvez rapidement des réponses à vos questions les plus courantes sur l'API YODI.

Premiers pas​

Comment commencer avec l'API YODI ?
  1. Créez un compte sur notre plateforme
  2. Générez une clé API dans votre tableau de bord
  3. Consultez notre guide de démarrage rapide
  4. Testez avec nos exemples de code
Où trouver ma clé API ?

Connectez-vous à votre compte YODI et rendez-vous dans la section "API Keys" de votre tableau de bord. Vous pouvez créer, gérer et révoquer vos clés API à tout moment.

L'API YODI est-elle compatible avec OpenAI ?

Oui ! Notre API est largement compatible avec l'API OpenAI. Vous pouvez généralement remplacer l'endpoint OpenAI par le nôtre avec des modifications minimales de votre code existant.

Aspects techniques​

Quels modèles sont disponibles ?
ModèleDescriptionCas d'usage principaux
yodi-1Modèle général conversationnelChat, Q&A, génération de texte
yodi-1-32kVersion étendue avec contexte longDocuments longs, analyses approfondies
yodi-instructOptimisé pour les instructionsTâches structurées, extraction de données
yodi-codeSpécialisé programmationGénération de code, débogage, documentation
yodi-embedGénération d'embeddingsRecherche sémantique, recommandations
Quelle est la limite de tokens par requête ?
  • yodi-1 : 4 096 tokens (contexte + réponse)
  • yodi-1-32k : 32 768 tokens
  • yodi-instruct : 4 096 tokens
  • yodi-code : 8 192 tokens
  • yodi-embed : 8 192 tokens d'entrée
Comment calculer le nombre de tokens ?

Un token représente environ 3-4 caractères en français. Utilisez notre calculateur de tokens ou nos bibliothèques SDK qui incluent des fonctions de comptage.

L'API supporte-t-elle le streaming ?

Oui ! Tous nos modèles de chat supportent le streaming en temps réel. Ajoutez simplement "stream": true à votre requête.

{
  "model": "yodi-1",
  "messages": [...],
  "stream": true
}

Facturation et plans​

Comment fonctionne la facturation des tokens ?

Vous êtes facturé uniquement pour les tokens consommés (tokens d'entrée + tokens de sortie). Les quotas non utilisés ne sont pas reportés au mois suivant.

Que se passe-t-il si je dépasse mon quota ?

Plan Gratuit/Développeur : Vos requêtes seront temporairement suspendues jusqu'au renouvellement du quota.

Plan Pro/Entreprise : Selon votre configuration, soit suspension temporaire, soit facturation des dépassements aux tarifs en vigueur.

Puis-je changer de plan à tout moment ?

Oui, les upgrades sont immédiats. Les downgrades prennent effet au prochain cycle de facturation pour éviter les interruptions de service.

Proposez-vous des remises pour les gros volumes ?

Oui, contactez notre équipe commerciale à sales@yodi.tg pour discuter de tarifs préférentiels selon votre volume d'utilisation.

Sécurité et confidentialité​

Mes données sont-elles sécurisées ?

Absolument. Nous appliquons les meilleures pratiques de sécurité :

  • Chiffrement TLS 1.3 pour toutes les communications
  • Chiffrement AES-256 pour le stockage
  • Conformité RGPD et certifications SOC2
  • Aucune conservation des données personnelles par défaut
YODI utilise-t-il mes données pour entraîner ses modèles ?

Non. Vos données ne sont jamais utilisées pour entraîner ou améliorer nos modèles, sauf autorisation explicite de votre part. Consultez notre politique de confidentialité pour plus de détails.

Où sont stockées mes données ?

Nos serveurs sont hébergés en Europe (France, Allemagne) dans des centres de données certifiés ISO 27001. Les données restent dans l'UE et respectent le RGPD.

Combien de temps conservez-vous les logs ?
  • Plan Gratuit : 7 jours
  • Plan Développeur : 30 jours
  • Plan Pro : 90 jours
  • Plan Entreprise : Jusqu'à 1 an (configurable)

Performance et fiabilité​

Quelle est la latence moyenne de l'API ?
  • Latence médiane : < 800ms
  • P95 : < 2s
  • P99 : < 5s

Les performances varient selon la complexité de la requête et la charge du système.

Quel est le SLA de disponibilité ?
  • Plan Gratuit : Effort commercial (pas de SLA)
  • Plan Développeur : 99%
  • Plan Pro : 99.5%
  • Plan Entreprise : 99.9%
Comment gérer les erreurs et les timeouts ?

Implémentez toujours une logique de retry avec backoff exponentiel :

import time
import random

def retry_with_backoff(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except Exception as e:
            if attempt == max_retries - 1:
                raise e
            wait_time = (2 ** attempt) + random.uniform(0, 1)
            time.sleep(wait_time)
Existe-t-il des limitations de taux ?

Oui, selon votre plan :

  • Gratuit : 10 requêtes/minute
  • Développeur : 60 requêtes/minute
  • Pro : 200 requêtes/minute
  • Entreprise : Personnalisable

Développement et intégration​

Quels langages de programmation sont supportés ?

Nous fournissons des SDK officiels pour :

  • Python (yodi-python)
  • JavaScript/Node.js (yodi-js)
  • cURL (exemples complets)

L'API REST peut être utilisée avec n'importe quel langage supportant HTTP.

Comment gérer l'authentification ?

Utilisez votre clé API dans l'header Authorization :

Authorization: Bearer your-api-key-here

Important : Ne jamais exposer votre clé API côté client. Utilisez un proxy backend pour les applications web.

Puis-je utiliser YODI dans une application mobile ?

Oui, mais uniquement côté backend. Ne jamais inclure votre clé API dans une application mobile. Créez une API intermédiaire qui proxy les requêtes vers YODI.

Comment implémenter un système de cache ?
import hashlib
import json
import time
from functools import wraps

def cache_response(ttl_seconds=300):
    cache = {}

    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            cache_key = hashlib.md5(
                json.dumps([args, kwargs], sort_keys=True).encode()
            ).hexdigest()

            if cache_key in cache:
                result, timestamp = cache[cache_key]
                if time.time() - timestamp < ttl_seconds:
                    return result

            result = func(*args, **kwargs)
            cache[cache_key] = (result, time.time())
            return result
        return wrapper
    return decorator

Support et communauté​

Où obtenir de l'aide ?

Documentation : docs.yodi.tg

Support technique :

Temps de réponse :

  • Gratuit : Forum communautaire
  • Développeur : 48h par email
  • Pro : 24h avec priorité
  • Entreprise : Support dédié 24/7
Comment signaler un bug ?
  1. Vérifiez que vous utilisez la dernière version de nos SDK
  2. Consultez les problèmes connus sur notre status page
  3. Envoyez un rapport détaillé à support@yodi.tg avec :
    • Code de reproduction minimal
    • Logs d'erreur complets
    • Version de votre SDK
    • Informations système
Existe-t-il une communauté de développeurs ?

Oui ! Rejoignez-nous sur :

Fonctionnalités avancées​

Qu'est-ce que le fine-tuning ?

Le fine-tuning permet d'adapter nos modèles à vos cas d'usage spécifiques en les entraînant sur vos données. Disponible à partir du plan Pro.

Processus :

  1. Préparez vos données d'entraînement
  2. Uploadez via notre interface
  3. Lancez l'entraînement (2-24h selon la taille)
  4. Testez et déployez votre modèle personnalisé
Comment utiliser les webhooks ?

Les webhooks permettent de recevoir des notifications en temps réel :

from flask import Flask, request
import hmac
import hashlib

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def handle_webhook():
    signature = request.headers.get('X-Yodi-Signature')
    payload = request.get_data()

    expected_signature = hmac.new(
        webhook_secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()

    if signature == f"sha256={expected_signature}":
        event = request.json
        print(f"Événement reçu : {event['type']}")

    return '', 200
Puis-je déployer YODI on-premise ?

Oui, c'est possible avec le plan Entreprise. Nous proposons :

  • Déploiement containerisé (Docker/Kubernetes)
  • Installation sur site avec support dédié
  • Hybrid cloud pour les cas d'usage mixtes

Résolution de problèmes​

Erreur 401 - Unauthorized

Causes communes :

  • Clé API invalide ou expirée
  • Clé API mal formatée dans l'header
  • Compte suspendu

Solutions :

  1. Vérifiez votre clé API
  2. Assurez-vous d'utiliser Bearer your-key dans l'Authorization header
  3. Contactez le support si le problème persiste
Erreur 429 - Too Many Requests

Cause : Vous avez dépassé les limites de taux de votre plan.

Solutions :

  1. Implémentez un système de retry avec backoff
  2. Optimisez vos requêtes (mise en cache, batching)
  3. Upgradez votre plan pour des limites plus élevées
Erreur 500 - Internal Server Error

Cause : Erreur temporaire de nos serveurs.

Solutions :

  1. Réessayez après quelques secondes
  2. Consultez notre status page
  3. Contactez le support si l'erreur persiste
Réponses incohérentes ou de mauvaise qualité

Optimisations :

  1. Ajustez la température (0.1 pour plus de cohérence, 0.9 pour plus de créativité)
  2. Améliorez vos prompts (plus de contexte, exemples, instructions claires)
  3. Utilisez le bon modèle (yodi-instruct pour les tâches structurées)
  4. Limitez max_tokens pour des réponses plus concises

Optimisation et bonnes pratiques​

Comment optimiser mes coûts ?
  1. Utilisez le cache pour les réponses similaires
  2. Minimisez le contexte en gardant seulement l'essentiel
  3. Choisissez le bon modèle selon la complexité de la tâche
  4. Implémentez des timeouts courts pour éviter les requêtes trop longues
  5. Analysez vos métriques dans le dashboard pour identifier les optimisations
Comment améliorer la qualité des réponses ?
  1. Prompts clairs et spécifiques avec exemples
  2. Contexte suffisant mais pas excessif
  3. Instructions explicites sur le format attendu
  4. Temperature adaptée à votre cas d'usage
  5. Tests A/B sur différentes formulations
Comment surveiller l'utilisation de l'API ?

Utilisez notre dashboard ou notre API de monitoring :

import requests

response = requests.get(
    "https://api.yodi.tg/v1/usage",
    headers={"Authorization": f"{api_key}"}
)

usage_data = response.json()
print(f"Tokens utilisés ce mois : {usage_data['tokens_used']}")
print(f"Quota restant : {usage_data['tokens_remaining']}")

Une question non couverte par cette FAQ ?

Réponse généralement sous 24h (selon votre plan de support).

Cette FAQ est mise à jour régulièrement. Dernière mise à jour : Janvier 2024