AI

Utilisez l’API AI dans vos applications et automatisations avec une clé API dédiée, des entrées texte et image, la diffusion en continu et des réponses structurées.

Lien : AI

Connexion/Inscription

1. Ouvrez Connexion.
2. Connectez-vous avec Apple, Google ou un code reçu par e-mail. Les nouveaux utilisateurs sont inscrits automatiquement.
3. Le même compte gère vos services AI, votre solde et vos documents de facturation.

Recharger le solde

1. Ouvrez Moyens de paiement et ajoutez des fonds avec un moyen disponible.
2. Conservez un solde suffisant pour le tarif mensuel affiché avant l’achat et les renouvellements à venir.

Acheter le service

1. Ouvrez AI.
2. Saisissez un nom pour votre application ou intégration, puis appuyez sur Continuer.
3. Vérifiez le tarif mensuel et confirmez la création. Ouvrez la commande AI dans Profil pour consulter sa clé API et sa limite de requêtes par minute.

Connecter votre application

Définissez AI_API_KEY de manière sécurisée avec la clé générée. Conservez-la sur votre serveur ; ne l’intégrez pas au code public de votre site ni aux paquets de votre application mobile.

Pour les clients dont l’URL de base de l’API est configurable, utilisez https://yoosolutions.com/api/v1/ai et le modèle ai. Le fournisseur et le modèle attribués à votre commande traitent la requête ; les fonctionnalités disponibles dépendent de ce modèle.

curl --request POST 'https://yoosolutions.com/api/v1/ai/chat/completions' \
  --header "Authorization: Bearer ${AI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"model":"ai","messages":[{"role":"user","content":"Résume l’avancement de ce projet."}]}'

Lisez la réponse dans choices[0].message.content du résultat JSON.

Requêtes prises en charge

• Envoyez du texte dans messages. Les messages utilisateur peuvent aussi contenir des parties image_url avec des données JPEG, PNG ou WebP en base64 ; les URL d’images distantes sont rejetées.
• Utilisez response_format avec text, json_object ou json_schema. Une réponse selon un schéma JSON nécessite strict: true.
• Définissez stream: true pour la diffusion en continu. Pour inclure les données d’utilisation, ajoutez aussi stream_options.include_usage: true.
• Contrôlez la longueur de la réponse avec max_completion_tokens. S’il est fourni, store doit être false ; les autres champs de requête non documentés sont rejetés.
• Les requêtes ne conservent pas l’état de la conversation. Incluez dans messages l’historique nécessaire à chaque requête.

Limites et facturation

• Les requêtes sont limitées à 20 MiB, 120 secondes et 16384 tokens de sortie, avec 4096 tokens de sortie par défaut.
• La limite de requêtes par minute affichée dans votre commande utilise une fenêtre glissante de 60 secondes et reste active après la réinitialisation de la clé.
• Les renouvellements sont prélevés sur votre solde. Si un renouvellement reste impayé, l’accès à l’API est bloqué jusqu’au paiement réussi. L’historique de facturation, les factures et les reçus sont disponibles dans Profil.

Gérer votre service

• Modifier change le nom du service sans modifier la clé, le modèle ni la limite.
• Réinitialiser génère une nouvelle clé API et révoque immédiatement l’ancienne. Mettez à jour la clé dans votre application ; la réinitialisation ne remet pas à zéro la limite de requêtes.
• Supprimer révoque l’accès à l’API et arrête les futurs prélèvements du service.

Dépannage

• 400 : vérifiez les champs de la requête, le modèle ai et le format des messages.
• 401 : vérifiez la clé bearer et mettez-la à jour après une réinitialisation.
• 402 : vérifiez le solde et le paiement du renouvellement dans Profil.
• 429 : avant de réessayer, attendez le nombre de secondes indiqué par l’en-tête Retry-After.
• 503 : le modèle ou fournisseur attribué est indisponible. Réessayez plus tard ou contactez le Support.