Passer au contenu principal
Cette page regroupe les règles communes relatives aux tâches et aux fichiers. Consultez les flux de travail CLI et les flux de travail MCP pour les étapes d’exécution.

Soumettre une seule fois et conserver l’identifiant de tâche

La génération peut renvoyer directement des sorties ou un task_id. Conservez l’identifiant, le modèle, les entrées et l’état indiqué, puis interrogez la tâche initiale jusqu’à son achèvement ou jusqu’à un échec confirmé. Interprétez les états réellement renvoyés ; l’expiration du délai d’attente d’un outil n’est pas un échec de génération. Les requêtes par lot et les listes conservent les tâches qu’elles ont pu vérifier et signalent les autres (partial, missing, details_missing). Un détail manquant ne signifie pas que la tâche n’a jamais existé ; interrogez à nouveau ces identifiants. Lorsqu’un état, un résultat ou un relevé de compte doit être vérifié, les réponses incluent dashboard_url et un dashboard_guidance en anglais. Connectez-vous à la console EvoLink avec le même compte EvoLink et conservez l’identifiant de la tâche initiale ; le lien seul ne confirme ni l’achèvement, ni une facturation, ni un remboursement. Les avis, les libellés de liens et les confirmations de génération sont en anglais par défaut ; demandez à l’assistant si vous préférez une autre langue. Les versions publiées de la CLI et de MCP ne proposent actuellement aucun moyen public utilisable d’annuler une tâche. Fermer un terminal, une conversation ou une connexion n’annule pas la tâche et ne prouve pas l’absence de facturation.

Reprendre après une expiration de délai ou une issue inconnue

1

Conserver l’identité initiale et l’enregistrement de la soumission

La CLI conserve le quote_id et son enregistrement de reprise ; MCP conserve le client_request_id, les entrées initiales et les erreurs. Préférez interroger un task_id existant plutôt que de générer à nouveau.
2

Reprendre par la voie initiale

Suivez la reprise dans la CLI ou la reprise dans MCP. Conservez l’identité, les entrées et l’identifiant de requête d’origine. Ne changez ni de compte, ni de clé, ni de voie (CLI ou MCP) pour soumettre à nouveau. EvoLink conserve un identifiant de requête pendant 24 heures : pendant ce délai, le même identifiant et les mêmes entrées renvoient la tâche initiale sans nouvelle facturation. Dans la CLI, tasks resume le rejoue dans les 23 heures suivant la première soumission, tant que le devis n’a pas expiré et que le prix n’a pas augmenté ; sinon, la commande n’envoie rien. Après 24 heures, l’identifiant n’empêche plus la création d’une seconde tâche ; vérifiez donc les tâches récentes avant de soumettre à nouveau.
3

Établir les faits concernant la tâche et la facturation

Enregistrez les sorties terminées ; après un échec confirmé, examinez la facturation. Si l’issue reste inconnue, conservez l’erreur et l’heure, puis contactez le support. Une issue inconnue ne signifie pas que rien n’a été généré ni facturé.

Rendre les références lisibles par le modèle

  1. Vérifiez les types d’image, de vidéo et d’audio acceptés, leur nombre, leur taille et les combinaisons de références autorisées.
  2. Utilisez un fichier lisible dans l’environnement d’exécution ou une URL accessible au serveur. Les pièces jointes d’une conversation et les chemins de fichiers de votre ordinateur ne sont pas automatiquement lisibles à distance.
  3. Confirmez le reçu d’importation et l’URL du fichier avant de l’ajouter aux entrées du modèle et d’estimer à nouveau.
  4. Conservez l’upload_id d’origine lorsque l’issue est inconnue. Ne demandez une importation de remplacement qu’après un échec confirmé ou une expiration ; la prise en charge des reçus dépend du déploiement.

Expiration et conservation

Les valeurs réellement renvoyées font foi. La compatibilité des reçus dépend du déploiement du service de fichiers. Les originaux téléchargés restent dans le stockage de l’utilisateur ; les URL temporaires, la documentation et les pièces jointes d’une conversation ne constituent pas un stockage permanent. Réimportez les références expirées et confirmez à nouveau les entrées modifiées.

Dépannage des téléchargements et des aperçus

  1. Interrogez la tâche initiale et confirmez qu’elle est terminée. Utilisez son URL d’origine ; des en-têtes ne peuvent pas réparer des liens expirés, privés ou invalides.
  2. Les utilisateurs de la CLI peuvent utiliser download. Les utilisateurs de MCP peuvent ouvrir les originaux dans un navigateur ou les enregistrer depuis un environnement capable de gérer des fichiers. Consultez Téléchargements avec la CLI et Livraison avec MCP.
  3. Vérifiez le code d’état HTTP, le Content-Type et le format réel. Une erreur en HTML ou en JSON n’est pas un média. Faites correspondre les extensions aux formats réels au lieu de renommer toutes les images en PNG.
  4. Ouvrez l’original lorsqu’un aperçu est gris ou que seul un lien apparaît. S’il fonctionne, livrez-le ou enregistrez-le. Les aperçus de l’hôte ne doivent pas déclencher une nouvelle génération ou une modification non approuvées.

Requêtes Python par défaut rejetées

Lorsqu’un original valide fonctionne dans un navigateur ou avec curl mais que la requête Python par défaut échoue, du code que vous contrôlez peut définir un User-Agent de produit. Cet exemple pour une image suppose que result_url est déjà une URL d’origine valide :
L’exemple rejette les réponses qui ne sont pas des images et évite d’écraser un fichier existant. Changez l’extension lorsque le format réel n’est pas PNG. La vidéo et l’audio exigent des vérifications MIME adaptées, des noms de fichiers correspondants et une vérification distincte. Cette approche n’a été vérifiée que pour certains cas de métadonnées et d’images, et non pour tous les clients, fichiers ou réseaux. Les téléchargements de la CLI définissent déjà un UA de produit.

Informations à fournir au support

Indiquez le système d’exploitation, l’agent et sa version, la version de la CLI ou de MCP, la voie utilisée, l’étape en échec, l’heure, le code d’erreur, le comportement attendu et le comportement constaté, le task_id existant, le quote_id ou le client_request_id, l’upload_id et des diagnostics expurgés. Précisez si SSH, des conteneurs ou des proxys sont utilisés. Masquez les jetons OAuth, les clés, les liens d’autorisation complets, les URL d’importation à usage unique, les URL privées signées et les fichiers privés. Ne partagez ni fichiers d’identifiants de connexion ni copies complètes de l’environnement. Commencez par le dépannage CLI ou le dépannage MCP pour repérer l’étape concernée.