Récapitulatif des questions fréquentes

Cette page regroupe par thème les questions les plus fréquentes sur l'utilisation de la plateforme. Chaque entrée indique la cause et les prochaines étapes à suivre ; pour un diagnostic plus fin au niveau des interfaces, voir Codes d'erreur et diagnostic ; pour les problèmes de l'atelier de création, voir Questions fréquentes sur la création web.

Compte et connexion

Pourquoi Creation me demande-t-il de me reconnecter ?

LocoPal Ai est l'unique source d'identité. Creation dépend du Cookie de session inter-sous-domaines émis par locopalai.com ; si ce Cookie est invalide ou absent, la sous-plateforme redirige vers la page de connexion unifiée.

Vérifiez d'abord : ouvrez LocoPal Ai et assurez-vous que vous êtes connecté. Si vous y êtes connecté mais que la sous-plateforme affiche toujours une déconnexion, actualisez la page de cette sous-plateforme ; si le problème persiste, déconnectez-vous de LocoPal Ai puis reconnectez-vous une fois.

Sur un nouvel ordinateur, faut-il se connecter séparément à Creation ?

Non. Une seule connexion à LocoPal Ai suffit ; Creation obtient automatiquement l'état de connexion.

La modification du mot de passe ou la déconnexion affecte-t-elle les autres plateformes ?

Oui. La déconnexion, le changement de compte et la modification du mot de passe invalident simultanément Creation ; c'est le comportement normal d'une session partagée.

Clés API

Une seule clé peut-elle appeler toutes les interfaces ?

Oui. Les interfaces de modèles, d'images, de vidéos, d'audio et de ressources partagent la même clé ; il n'est pas nécessaire d'en créer une par interface.

Pourquoi cette clé ne voit-elle pas un certain modèle ?

La portée des modèles visibles est déterminée par le groupe d'appel auquel la clé appartient. Interrogez GET /v1/models avec cette clé pour vérifier : si le modèle n'apparaît pas dans les data renvoyées, il ne fait pas partie des autorisations de ce groupe.

Que signifie un retour "data": [] ?

Cela signifie qu'aucun modèle n'est disponible dans le groupe de la clé actuelle. Vérifiez d'abord que la configuration du groupe est correcte ; en cas de doute, contactez le support de la plateforme en fournissant le nom de la clé (sans fournir la clé complète).

Que faire si une clé a été divulguée ?

Désactivez immédiatement cette clé dans « Clés API » de la console (plutôt que d'attendre son expiration naturelle), puis créez une nouvelle clé pour votre activité et remplacez la configuration. La désactivation n'affecte pas les ressources, les tâches et l'historique du compte.

Pourquoi ne pas écrire la clé dans le code front-end ?

Tout contenu présent dans un navigateur ou un paquet d'installation mobile peut être extrait. La clé doit être placée dans une variable d'environnement serveur ou un service de gestion de secrets, et c'est votre backend métier qui appelle la plateforme pour le compte de vos utilisateurs.

Modèles et appels

Que faut-il mettre dans model d'une requête ?

Indiquez tel quel le data[].id renvoyé par GET /v1/models. N'utilisez pas le nom affiché sur la page de la place de marché des modèles.

Message « Modèle temporairement indisponible » ou « Aucun canal disponible »

Cela signifie que le modèle ne peut pas être routé pour le moment, et non que la clé présente un problème. Actualisez d'abord la liste des modèles ou utilisez un modèle équivalent ; si l'indisponibilité persiste, contactez le support de la plateforme en fournissant l'ID de requête.

L'appel texte renvoie un content vide et finish_reason vaut length

Un modèle de raisonnement peut avoir consommé tout max_tokens dans le processus de raisonnement (completion_tokens_details.reasoning_tokens). Augmentez la limite de sortie, ou passez à un modèle sans raisonnement avant de réessayer.

L'interface d'image renvoie unknown_parameter

Certains modèles d'image (comme la série GPT Image) n'acceptent pas le champ response_format. Il suffit de le retirer avant de réessayer. La prise en charge de size, quality et response_format dépend du modèle actuel.

L'URL d'image renvoyée ne s'ouvre pas

L'interface d'image peut renvoyer une adresse temporaire ; sauvegardez-la rapidement dans votre propre stockage. Les images à réutiliser à long terme doivent d'abord être importées dans la bibliothèque de ressources, puis référencées via asset://<asset_id>.

Tâches vidéo

Pourquoi la vidéo est-elle asynchrone ?

La génération vidéo est longue ; la plateforme utilise le modèle « créer une tâche → interroger le résultat ». L'interface de création renvoie un ID de tâche, puis l'interface d'interrogation permet d'actualiser la progression et le résultat.

En cas de délai d'attente local après la soumission, faut-il recréer la tâche ?

Non. Une fois l'ID de tâche obtenu, même en cas de délai d'attente local, il faut uniquement continuer à interroger la tâche d'origine. La recréer générerait une tâche et des frais en double.

L'absence de progress dans la réponse de création signifie-t-elle un échec ?

Non. La réponse de création ne doit dépendre que de id / task_id, status, model et created_at ; des champs comme object et progress peuvent n'apparaître qu'à la première interrogation et ne doivent pas être considérés comme des conditions nécessaires à une création réussie.

Le statut est failed, comment en connaître la cause ?

Lisez error.code et error.message dans la même réponse. Un échec terminal vidéo renvoie généralement video_generation_failed ; error.message contient déjà une raison lisible et nettoyée, ne cherchez pas à en réanalyser le JSON.

L'interrogation entraîne-t-elle une facturation en double ?

Non. L'interrogation ne fait que lire l'état et ne génère pas de frais. Seule la recréation d'une tâche génère de nouveaux frais, ce qui explique pourquoi il ne faut pas soumettre en double.

Ressources et autorisation de portrait

Faut-il téléverser les ressources séparément pour chaque modèle ?

Non. Une ressource ne s'importe qu'une fois, dans la bibliothèque de ressources unifiée de la plateforme ; tous les modèles prenant en charge les références de ressources utilisent la même ressource, l'ID de ressource reste identique, et changer de modèle ne demande que de modifier le champ model de la requête.

Quand une ressource est-elle utilisable ?

Elle n'est utilisable de façon stable qu'une fois data.asset.status passé à Active. Lorsque « Téléversement en cours » ou « Traitement en cours » s'affiche, conservez la ressource et attendez ; ne soumettez pas de façon répétée le même élément en échec.

Quelle adresse d'image utiliser pour soumettre une ressource ?

Utilisez une adresse http(s) directement téléchargeable depuis l'internet public, ou soumettez un data_url selon les limites de l'interface. N'utilisez pas un chemin de fichier local du navigateur comme paramètre d'interface.

Une ressource de portrait peut-elle être remplacée par une image ordinaire ?

Non. Les ressources de portrait doivent être collectées et autorisées par la personne elle-même, via un scan de code QR sur son téléphone pour la détection de vivacité. Le parcours dans la console est : « Gestion de la bibliothèque de ressources → Nouveau groupe → Bibliothèque de ressources de portrait → Générer un code QR → Scan par la personne concernée → Scan terminé, lancer la synchronisation ».

Que se passe-t-il si l'on passe à un modèle ne prenant pas en charge les ressources de portrait ?

Les ressources de portrait ne prennent effet que sur les modèles qui les prennent explicitement en charge. Lors du passage à un modèle non pris en charge, la plateforme ne les convertit pas automatiquement en images de référence ordinaires ; utilisez plutôt des ressources virtuelles ou revenez à un modèle compatible.

Les ressources ont-elles un impact sur les autres modèles ?

L'import est indépendant du modèle. Une fois la ressource disponible, elle peut être utilisée dans tout modèle prenant en charge les références de ressources, sans attendre une nouvelle préparation côté modèle. Les ressources existantes sont préparées une fois par la plateforme lors de leur première référence.

Facturation et solde

La soumission d'une tâche vidéo entraîne-t-elle un débit immédiat ?

Non. Les tâches asynchrones sont décomptées à l'achèvement ; une soumission réussie ne fait qu'accepter la tâche, sans pré-autorisation. Avant la soumission, la plateforme vérifie que le solde ou le quota de la clé couvre l'estimation de cette requête ; en cas d'insuffisance, elle renvoie directement un message lisible sans créer la tâche.

Un échec de validation des paramètres (400) entraîne-t-il des frais ?

Généralement non. Un 400 signifie que la requête n'a pas été acceptée et ne génère en principe pas de frais de tâche de génération.

Le prix affiché sur la carte tarifaire correspond-il au débit final ?

Non. La carte tarifaire sert à l'estimation ; le débit réel dépend de l'usage effectif de la requête, du groupe concerné et des enregistrements de facturation côté serveur. Voir Facturation et relevés.

En cas de débit suspect, comment le vérifier ?

Utilisez l'ID de tâche, l'identifiant de requête, l'ID de modèle et la plage horaire pour localiser l'enregistrement précis, puis comparez avec le détail du relevé. Ne fournissez pas de clé complète.

Plateformes et outils de création

Quelle est la relation entre les deux plateformes ?

LocoPal Ai est le cœur du système : il fournit les comptes, la facturation, les modèles, les ressources et l'historique des tâches ; Creation est un client qui s'y connecte. Voir Vue d'ensemble des plateformes.

Les ressources générées dans Creation sont-elles utilisables via l'API ?

Oui. Les deux partagent la même bibliothèque de ressources, avec les mêmes ID de ressource.

Actualiser la page régénère-t-il le contenu ou refacture-t-il ?

Non. L'actualisation ne restaure que l'état de la page, sans recréer de tâche ni facturer à nouveau. Ne soumettez pas plusieurs fois une tâche encore en cours d'exécution.

Toujours pas résolu

Lors d'une demande de support, veuillez fournir : l'heure de l'incident, le nom du modèle, l'ID de tâche ou l'ID de requête, le statut HTTP (en cas d'appel d'interface), le message d'erreur anonymisé, ainsi que le type de requête (texte / image / vidéo / audio).

Ne transmettez pas : de clés API, d'en-tête Authorization complet, de Cookie de connexion, de données de portrait réelles, ou d'adresse complète de ressource signée. Pour le périmètre concerné, voir Codes d'erreur et diagnostic.