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).
Extraire le texte
Section intitulée « Extraire le texte »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.
Extraire le résumé d’image
Section intitulée « Extraire le résumé d’image »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-flashetdeepseek-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.
Traduire
Section intitulée « Traduire »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.
Champs de configuration de l’IA générique
Section intitulée « Champs de configuration de l’IA générique »URL de l’API
Section intitulée « URL de l’API »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.
Identifiant du modèle
Section intitulée « Identifiant du modèle »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.
Capacités du modèle
Section intitulée « Capacités du modèle »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.
Concurrence
Section intitulée « Concurrence »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.
Limite de débit
Section intitulée « Limite de débit »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.
Intervalle entre requêtes
Section intitulée « Intervalle entre requêtes »Le délai minimal entre le lancement de deux requêtes consécutives, en secondes. Augmentez-le lorsqu’un fournisseur limite vos requêtes.
Relances automatiques
Section intitulée « Relances automatiques »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.
Paramètres avancés
Section intitulée « Paramètres avancés »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.
Remplacement de requête
Section intitulée « Remplacement de requête »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 : remplacement des en-têtes de requête
Section intitulée « headers : remplacement des en-têtes de requête »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.
nullsupprime 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.
nullsupprime 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 : remplacement du corps de la requête
Section intitulée « body : remplacement du corps de la requête »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
nullest 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 nonnull, 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.
Vérifications avant l’enregistrement
Section intitulée « Vérifications avant l’enregistrement »- Le contenu de
headers,queryetbodydoit être un objet JSON valide. headersetqueryutilisent des valeurs plates de type chaîne ounull; n’y écrivez pas d’objets imbriqués.- Seul
bodyprend 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.