Aide et référence
Cette page harmonise la définition des termes employés dans la documentation et l'interface de la plateforme, afin d'éviter qu'un même concept porte des noms différents d'une page à l'autre.
| Terme | Signification |
|---|
| LocoPal Ai | Plateforme API et cœur de tout l'écosystème : elle fournit les comptes, la connexion, la facturation, le catalogue de modèles, la bibliothèque de ressources et l'historique des tâches. Entrée locopalai.com. |
| LocoPal Creation | Plateforme de création (atelier web), destinée à la création directe sans écrire de code. Entrée creation.locopalai.com. |
| Console | Interface d'administration de LocoPal Ai après connexion, comprenant la place de marché des modèles, les clés API, les journaux, la gestion de la bibliothèque de ressources, le portefeuille, etc. |
| Terme | Signification |
|---|
| Clés API | Identifiants d'appel des interfaces de la plateforme, de la forme sk-.... Une même clé permet d'appeler les interfaces de modèles, d'images, de vidéos, d'audio et de ressources. |
| Access Token | Jeton d'appel à court terme. Le front-end de la plateforme ne le conserve qu'en mémoire, sans l'écrire dans localStorage. |
| Jeton de rafraîchissement / Cookie de session | Sert à restaurer l'état de connexion après l'actualisation d'une page. Sa portée est .locopalai.com, ce qui permet aux deux plateformes de partager la connexion. |
| Connexion unifiée | Une seule connexion à LocoPal Ai suffit ; les autres plateformes obtiennent automatiquement l'état de connexion. LocoPal Ai est l'unique source d'identité. |
| Expiration de la session | Après une déconnexion, un changement de compte ou une modification du mot de passe, les sessions de les deux plateformes sont invalidées en même temps et une nouvelle connexion est nécessaire. |
| Terme | Signification |
|---|
| ID de modèle | Valeur à indiquer dans le champ model d'une requête, issue du data[].id renvoyé par GET /v1/models. Ce n'est pas le nom affiché sur la page. |
| Place de marché des modèles | Entrée pour consulter les noms, capacités, paramètres, prix et groupes disponibles des modèles. |
| Groupe d'appel / groupe | Périmètre d'autorisation qui détermine quels modèles une clé peut voir et appeler. Un groupe contient plusieurs canaux, et chaque canal porte plusieurs modèles. |
| Canal | Voie qui porte réellement les modèles au sein d'un groupe. La disponibilité d'un modèle dépend de la possibilité de le router vers un canal disponible. |
| Adresse de base (Base URL) | Préfixe des interfaces, par exemple https://locopalai.com. Indiquez uniquement le domaine, sans ajouter /v1 de façon répétée. |
us-api.locopalai.com | Adresse d'accès alternative pour les modèles étrangers ou certains environnements réseau. L'adresse utilisée fait foi via son propre /v1/models. |
| Appel synchrone | Appel qui renvoie le résultat dès la fin de la requête, comme le texte, l'image ou l'audio. |
| Tâche asynchrone | Appel qui crée d'abord une tâche pour obtenir un ID, puis interroge le résultat, comme la génération vidéo. |
| Terme | Signification |
|---|
| Bibliothèque de ressources | Stockage unifié des ressources de la plateforme, organisé par groupes. Une importation unique suffit pour être réutilisée par tous les modèles prenant en charge les références de ressources. |
| Groupe de ressources | Conteneur de ressources, réparti en deux types : virtuel (virtual) et personne réelle (real). |
| Ressource virtuelle | Ressource d'image téléversée ou générée, adaptée à la conservation de personnages, produits, styles et autres éléments réutilisables. |
| Ressource de portrait | Données d'une personne réelle qui doivent être collectées et autorisées par la personne elle-même via un scan de code QR sur son téléphone ; un téléversement d'image ordinaire ne peut pas s'y substituer. |
| ID de ressource | Identifiant unique de la ressource, identique d'un modèle à l'autre. |
asset://<asset_id> | Forme de référence dans une requête à une ressource déjà importée. À utiliser uniquement après que le statut de la ressource est passé à Active. |
Active | L'un des statuts de ressource : indique que la ressource est traitée et utilisable de façon stable sur les modèles prenant en charge les références de ressources. |
Processing | La ressource est encore en cours de traitement. Ce n'est pas une erreur ; continuez à interroger avec le même ID de ressource. |
data_url | Forme de soumission en ligne des données d'image (data:image/...;base64,...) ; un seul des deux champs, data_url ou image_url, peut être soumis. |
| Terme | Signification |
|---|
| ID de tâche | Identifiant d'une tâche asynchrone. Il doit être conservé après la création ; même en cas de délai d'attente local, suivez la tâche par interrogation plutôt qu'en la recréant. |
| Journaux de tâches | Entrée pour consulter le détail d'exécution des tâches asynchrones : heure de soumission, ID de tâche, durée, état, progression et artefacts. |
| Journaux d'utilisation | Entrée pour consulter le détail des appels synchrones : modèle, Tokens et frais. |
queued / En file d'attente | La tâche a été acceptée et attend son exécution. |
processing / En génération | La tâche est en cours d'exécution ; vous pouvez quitter la page et revenir plus tard à l'enregistrement d'origine. |
succeeded / Terminé | Le résultat est généré et peut être téléchargé ou référencé. |
failed / Échec | Échec terminal de la tâche. Lisez error.code et error.message dans la même réponse. |
video_generation_failed | Code d'échec terminal des tâches vidéo ; error.message contient déjà une raison lisible et nettoyée. |
| Artefact | Produit d'une tâche : image, vidéo ou audio directement prévisualisable ou téléchargeable. |
| Instantané de requête | Contenu de la requête et JSON de requête d'origine d'une tâche. Visible uniquement par les administrateurs ; ce champ n'est pas renvoyé lorsqu'un utilisateur ordinaire interroge ses propres tâches. |
| Terme | Signification |
|---|
| Facturation au Token | Facturation séparée des Tokens d'entrée et de sortie, l'unité affichée étant 1K ou 1M Tokens. |
| Entrée en cache / écriture en cache | Poste de facturation affiché uniquement pour les modèles prenant en charge la mise en cache des prompts. |
| Facturation à la requête | Chaque requête réussie est facturée à un prix fixe. |
| Matrice tarifaire | Tableau de prix des modèles vidéo, présenté selon « avec ou sans entrée vidéo » × « résolution de sortie ». |
| Décompte à l'achèvement | Le débit réel d'une tâche asynchrone intervient à son achèvement ; la soumission ne fait qu'accepter la tâche, sans pré-autorisation. |
| Portefeuille | Entrée pour la recharge, les forfaits, les commandes et les relevés. |
| Consommation estimée | Estimation des frais avant la soumission d'une tâche. Si le solde est insuffisant pour la couvrir, un message est renvoyé directement et aucune tâche n'est créée. |
| Terme | Signification |
|---|
Limitation de débit / 429 | Requêtes trop fréquentes. Effectuez une nouvelle tentative après un recul, sans réessayer en parallèle. |
task_concurrency_exceeded | La limite de tâches simultanées est atteinte. Conservez les ID de tâches existants et attendez avant que l'utilisateur ne soumette volontairement à nouveau. |
| Nouvelle tentative avec recul (backoff) | Après un échec, attendre un certain temps avant de réessayer, en allongeant progressivement l'attente plutôt qu'en réessayant immédiatement en rafale. |
| RequestId / ID de requête | Identifiant d'une requête individuelle, utilisé pour localiser l'enregistrement précis lors d'un diagnostic. |
400 échec de validation des paramètres | La requête n'a pas été acceptée et ne génère généralement pas de frais de tâche de génération. |
Cette page vous a-t-elle aidé ? 