Aller au contenu
Cette page a été traduite par IA et peut contenir des erreurs. Lire l’original en anglais

Configuration des services : IA générique

Cette page sert de référence aux utilisateurs intermédiaires et avancés ainsi qu’aux développeurs. Elle peut être utile pour configurer manuellement d’autres services tiers.

Quelles capacités l’IA générique fournit-elle ?

Section intitulée « Quelles capacités l’IA générique fournit-elle ? »

L’IA générique sert à :

  • Extraire le texte
  • Extraire le résumé d’image
  • Traduire

Détecter les blocs de texte ne fait pas partie de l’IA générique. Cette capacité nécessite un service dédié de détection des blocs de texte.

Comment choisir un modèle d’IA générique adapté

Section intitulée « Comment choisir un modèle d’IA générique adapté »
  • Extraire le texte et Extraire le résumé d’image nécessitent des capacités visuelles.
  • Pour la traduction, privilégiez un modèle à la qualité linguistique stable et à la longueur de contexte suffisante.
  • Surveillez le coût en tokens du modèle. Vous pouvez d’abord faire un essai sur un petit lot.
  • Pour réduire les coûts, utilisez un modèle local.

Extraire le texte et Extraire le résumé d’image

Section intitulée « Extraire le texte et Extraire le résumé d’image »

Ces deux tâches nécessitent un modèle doté de capacités visuelles. Dans la terminologie des produits, on parle généralement de modèles multimodaux ou de modèles vision-langage (VLM).

Les principaux modèles dotés de capacités visuelles donnent généralement de bons résultats, notamment avec le texte irrégulier, le texte hors des bulles et les onomatopées stylisées (SFX). Ils peuvent aussi, dans une certaine mesure, filtrer les furigana japonais.

Ainsi, même si le modèle utilisé pour Détecter les blocs de texte a déjà renvoyé du texte, repasser ce texte dans un modèle vision-langage peut encore être utile, bien que l’amélioration risque d’être limitée.

Le raisonnement n’aide pas pour l’extraction de texte. Il est généralement préférable de désactiver le raisonnement pour économiser des tokens et du temps.

Un résumé d’image précis peut décrire la scène et son ambiance, ce qui améliore la qualité de la traduction. En revanche, un modèle moins performant peut halluciner des détails et induire la traduction en erreur. Choisissez avec soin un modèle performant.

Modèles de référence :

  • Les modèles de niveau égal ou supérieur à gpt-6-sol (high) donnent de très bons résultats.
  • OpenRouter : google/gemma-4-31b-it — moyen. Le Guide de démarrage rapide l’utilise parce qu’il est peu coûteux et efficace pour Extraire le texte, et non parce qu’il serait le meilleur choix pour les résumés d’image.
  • mimo-v2.6-flash — moyen.
  • glm-5.3-flash et deepseek-v4.1-flash — sujets à de fortes hallucinations ; déconseillés pour cette tâche.

Le raisonnement a un effet important sur cette tâche. Utilisez un niveau de raisonnement élevé lorsque c’est possible. La capacité des modèles d’IA généralistes à interpréter les mangas pourrait s’améliorer avec le temps.

Pour la traduction, privilégiez une qualité linguistique stable et une longueur de contexte suffisante. Modèles de référence :

  • DeepSeek officiel : deepseek-v4-flash, effort de raisonnement Élevé. Rapide, il produit de bons résultats.
  • Zhipu : glm-5.3-flash, effort de raisonnement Maximum. Sa précision est relativement élevée.
  • Xiaomi Mimo : mimo-v2.6-flash, effort de raisonnement Maximum. Un peu moins bon que les deux précédents, mais tout à fait utilisable.

Le point de terminaison qui reçoit les requêtes. Les préréglages le fournissent normalement. Modifiez-le si vous utilisez Ollama ou un autre service local compatible.

La clé délivrée par le fournisseur. Les services locaux peuvent laisser ce champ vide. La clé est stockée dans le stockage sécurisé de l’appareil et supprimée lorsque la configuration de service correspondante est supprimée.

Le nom exact du modèle envoyé au fournisseur. Il doit correspondre à un modèle pris en charge par ce fournisseur. Un nom d’affichage personnalisé ne modifie pas l’identifiant envoyé dans la requête.

Les capacités déterminent quelles actions d’automatisation peuvent utiliser un modèle.

Ne déclarez pas les capacités Extraire le texte ou Extraire le résumé d’image pour un modèle qui n’accepte pas d’image en entrée. Une déclaration de capacité incorrecte peut activer une action dont la requête finira par échouer.

Le nombre de requêtes exécutées simultanément. Des valeurs plus élevées sont généralement plus rapides, mais risquent davantage de déclencher des limites de débit et consomment plus de mémoire. 0 signifie illimité. En cas de doute, conservez la valeur prédéfinie.

Le nombre maximal de requêtes lancées pendant une période donnée. Ce n’est pas la même chose que la concurrence : la concurrence limite le travail simultané, tandis que la limite de débit limite le nombre de requêtes lancées sur une période. 0 désactive la limite.

Le délai minimal entre le lancement de deux requêtes consécutives, en secondes. Augmentez-le lorsqu’un fournisseur limite vos requêtes.

Le nombre de nouvelles tentatives après l’échec d’une requête. 0 désactive les relances automatiques. Les relances peuvent entraîner des frais auprès du fournisseur ; si l’erreur est due à une clé API invalide ou à un modèle inconnu, augmenter le nombre de relances n’aidera généralement pas.

La température, les limites de tokens, Top P et les paramètres similaires affectent directement la requête envoyée au modèle. Laissez-les vides pour utiliser les valeurs par défaut du fournisseur ou du modèle. Ne les renseignez pas, sauf si vous savez que le fournisseur prend en charge le paramètre.

Le remplacement de requête (requestOverride) gère les différences entre un fournisseur et le format de requête standard compatible OpenAI. Il peut modifier les en-têtes de requête, les paramètres de requête de l’URL et le corps de la requête sans changer la logique de requête générale de l’application.

Un remplacement de requête doit être un objet JSON :

{
"headers": {},
"query": {},
"body": {}
}

Conservez les trois champs. Utilisez un objet vide {} pour une section qui ne nécessite aucun remplacement.

headers et query prennent en charge l’espace réservé {{API_KEY}}. Avant l’envoi de la requête, il est remplacé par la clé API de la configuration actuelle. Ne placez pas une vraie clé API directement dans un remplacement de requête et ne la validez pas dans une documentation ou un dépôt.

headers est un objet JSON plat. Les clés sont des noms d’en-tête, et les valeurs doivent être des chaînes ou null :

  • Une chaîne ajoute ou remplace un en-tête.
  • null supprime le champ correspondant des en-têtes par défaut de l’application.

Par exemple, pour ajouter un en-tête exigé par un fournisseur :

{
"headers": {
"X-Provider-Version": "2026-01"
},
"query": {},
"body": {}
}

query : remplacement des paramètres de requête de l’URL

Section intitulée « query : remplacement des paramètres de requête de l’URL »

query est aussi un objet plat. Il modifie les paramètres de requête qui suivent l’URL de l’API :

  • Une chaîne ajoute ou remplace un paramètre de requête.
  • null supprime un paramètre de requête.

Par exemple, certains fournisseurs exigent la clé API dans un paramètre de requête key :

{
"headers": {},
"query": {
"key": "{{API_KEY}}"
},
"body": {}
}

Un remplacement de requête peut modifier les paramètres de requête, mais pas la méthode HTTP ni le chemin de l’API.

body est un correctif partiel appliqué au corps de la requête, et non un corps de requête complet. L’application crée d’abord les paramètres de requête communs, puis y fusionne ce contenu :

  • Les champs ordinaires ajoutent ou remplacent les champs de même nom.
  • Les objets imbriqués sont fusionnés récursivement ; remplacer un champ enfant ne supprime pas les champs voisins.
  • Un champ dont la valeur est null est supprimé du corps de requête final.
  • Les nombres, chaînes, booléens et tableaux remplacent directement la valeur de même nom.

Par exemple, pour ajouter des paramètres propres à un fournisseur :

{
"headers": {},
"query": {},
"body": {
"response_format": {
"type": "json_object"
},
"vendor_option": "value"
}
}

Utilisez null pour supprimer un champ que l’application enverrait sinon :

{
"headers": {},
"query": {},
"body": {
"reasoning": null,
"reasoning_effort": null
}
}

Le remplacement du corps est appliqué après les paramètres du modèle et les paramètres de raisonnement. Les valeurs de body ont donc la priorité sur les paramètres communs et les correspondances de raisonnement. Un remplacement incorrect peut rendre la requête incompatible avec le fournisseur.

Remplacements au niveau du fournisseur et du modèle

Section intitulée « Remplacements au niveau du fournisseur et du modèle »

Un remplacement de requête peut provenir de deux niveaux :

  • Remplacement au niveau du fournisseur : le remplacement par défaut du fournisseur, généralement fourni par le catalogue des fournisseurs.
  • Remplacement au niveau du modèle : un remplacement qui s’applique à un seul modèle.

Les remplacements au niveau du modèle suivent ces états de valeur :

  • null : hérite du remplacement au niveau du fournisseur.
  • Un objet non null : remplace l’objet du niveau fournisseur dans son ensemble ; il n’est pas fusionné en profondeur avec lui.
  • {} : également un objet non null, qui signifie que ce modèle n’utilise explicitement aucun remplacement au niveau du fournisseur.

Par conséquent, si un remplacement au niveau du modèle ne modifie qu’un seul champ d’un remplacement au niveau du fournisseur, il doit aussi inclure les autres champs du niveau fournisseur à conserver.

Valeurs par défaut du catalogue et modifications manuelles

Section intitulée « Valeurs par défaut du catalogue et modifications manuelles »

Lorsqu’une configuration est créée à partir du catalogue des fournisseurs, l’application peut renseigner automatiquement un remplacement de requête. Tant que vous ne le modifiez pas manuellement, la configuration continue de suivre les mises à jour des valeurs par défaut du catalogue.

Après une modification manuelle d’un remplacement de requête, l’application le marque comme contenu personnalisé et ne remplace plus votre saisie par les valeurs par défaut du catalogue à l’ouverture de la page des paramètres. Sélectionnez Restaurer les valeurs par défaut pour utiliser à nouveau le remplacement fourni par le catalogue.

  • Le contenu de headers, query et body doit être un objet JSON valide.
  • headers et query utilisent des valeurs plates de type chaîne ou null ; n’y écrivez pas d’objets imbriqués.
  • Seul body prend en charge les objets imbriqués et la fusion en profondeur.
  • Privilégiez les valeurs fournies automatiquement par le catalogue des fournisseurs.
  • En cas de doute sur la prise en charge d’un champ par un fournisseur, consultez d’abord sa documentation d’API.
  • Testez la configuration enregistrée sur une seule image avant de l’exécuter sur un tome entier.