Premiers pas

Ce guide accompagne un utilisateur en libre-service de l'inscription à la première requête API. Si votre organisation est connectée par OmevAI, utilisez l'accès et la clé fournis lors de la configuration gérée ; les étapes API ci-dessous sont identiques.

1. Créer un compte en libre-service

1. Ouvrez cabinet.omev.be et sélectionnez Démarrer l'essai gratuit.
2. Saisissez votre adresse e-mail professionnelle et décrivez comment vous utilisez l'IA. Les informations sur l'entreprise et le volume mensuel attendu sont facultatifs.
3. Effectuez la vérification du navigateur et soumettez le formulaire.
4. Ouvrez l'e-mail d'OmevAI. Il contient un lien de connexion et un code à six chiffres ; les deux méthodes fonctionnent.
5. Après la vérification, le cabinet crée le compte et affiche la clé API initiale.

L'essai en libre-service inclut 5 USD de crédit pour 10 jours et ne nécessite pas de carte de paiement. L'API texte et l'API de langage naturel fonctionnent sur toutes les clés ; les images, la vidéo et les produits de recherche sont activés pour une clé sur demande.

2. Sauvegarder la clé

Copiez la clé complète directement dans votre gestionnaire de mots de passe ou votre système de gestion des secrets. Pour la clé initiale, l'écran Clés peut fournir une action supplémentaire Afficher la clé une seule fois. Une fois cet affichage unique utilisé, seul un masque est disponible. Une clé créée ultérieurement dans un écran de l'organisation doit être copiée lors de sa création.

Ne mettez jamais une clé dans du JavaScript côté client, une application mobile, un dépôt public, une capture d'écran ou un message de support. Les exemples ci-dessous supposent que la clé est stockée sur le serveur sous le nom OMEV_API_KEY.

3. Vérifier ce que la clé peut utiliser

curl -sS https://llmapi.omev.be/v1/models \
  -H "Authorization: Bearer $OMEV_API_KEY"

Développez uniquement en utilisant les noms publics documentés omev-* renvoyés pour votre clé. Les produits d'imagerie n'apparaissent qu'après l'activation de leur accès. Les prix de tous les produits figurent sur Modèles et prix.

4. Envoyer la première requête de texte

curl -sS https://llmapi.omev.be/v1/chat/completions \
  -H "Authorization: Bearer $OMEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "omev-lite",
    "messages": [
      {"role": "system", "content": "Follow the requested format carefully."},
      {"role": "user", "content": "Summarise this text in five bullets: ..."}
    ],
    "temperature": 0.2,
    "max_tokens": 500,
    "stream": false
  }'

La réponse se trouve dans choices[0].message.content. Consultez Modèles pour Python, la sélection de modèles, le streaming et le JSON structuré.

5. Tester une requête exacte dans le Playground

Ouvrez le Playground dans le cabinet web lorsque vous souhaitez tester le même corps JSON que votre application enverra. Vous pouvez coller une commande curl existante ou construire une requête dans le formulaire. Le Playground affiche la réponse, le nombre de tokens, la durée, le corps de la requête et des exemples de code pour curl, Python et NodeJS.

Le Playground vérifie la compatibilité technique d'un futur appel API. Ce n'est ni une file de production ni une interface alternative pour un travail IA continu. Utilisez le Chat séparément lorsque vous devez évaluer la qualité des réponses sur des requêtes API futures représentatives.

La clé dans le code copié est masquée. Remplacez le masque par OMEV_API_KEY ou une référence à votre gestionnaire de secrets avant d'exécuter l'exemple en dehors du navigateur.

6. Examiner l'utilisation et les coûts

Les comptes en libre-service utilisent le Tableau de bord, l'Utilisation, le Journal et la Facturation dans le cabinet web. Les appels récents peuvent mettre quelques minutes à apparaître.

Les clients entreprise reçoivent également un accès à usage.omev.be une fois que l'organisation et le premier propriétaire approuvé sont provisionnés. Le propriétaire peut inviter d'autres personnes sans demander à OmevAI de saisir manuellement chaque adresse e-mail.

7. Continuer en toute sécurité

• Utilisez des clés distinctes lorsque le cabinet et votre rôle le permettent et qu'un contrôle séparé est utile.
• Définissez max_tokens pour plafonner les jetons de sortie facturés, configurez des délais d'attente et un petit nombre maximum de tentatives.
• Réessayez les réponses 429, les réponses 5xx temporaires et les erreurs réseau transitoires avec un délai croissant. Ne répétez pas une requête 400, 401, 403, 404 ou 413 inchangée.
• Validez la sortie structurée dans votre propre application.
• Conservez les identifiants de requête et les masques de clé dans les journaux, jamais les clés complètes ou les prompts confidentiels.

Pour des questions d'accès ou un problème non résolu, contactez support@omev.be. Incluez l'adresse e-mail du compte, l'heure approximative et le fuseau horaire, le point de terminaison, le modèle public, le statut, l'identifiant de la requête lorsqu'il est disponible, et un exemple nettoyé.