L’API GPT Image 2.5 est disponible. Créez et modifiez des images →
PoYoPoYo
Toutes les intégrations

Guide d'intégration

Installez PoYo pour ComfyUI

Flux de travail d'IA visuelle locale

Utilisez des modèles d'image, de vidéo et d'audio PoYo à côté des nœuds ComfyUI locaux, avec des connexions visuelles et des sorties de fichiers.

Avant de commencer

  • ComfyUI 0.32.0 ou version ultérieure
  • Git et une clé PoYo API

Trois étapes pour une configuration vérifiée

Effectuez les étapes dans l'ordre. Chaque étape comprend le lieu d'action et le résultat qui confirme que vous pouvez continuer.

  1. 1

    Vérifiez votre version ComfyUI

    Mettez à jour ComfyUI avant d'installer le pack de nœuds si votre version est antérieure à 0.32.0.

    Continuez quand: ComfyUI signale la version 0.32.0 ou ultérieure.
  2. 2

    Installez les nœuds et redémarrez ComfyUI

    Clonez le référentiel officiel dans custom_nodes, puis redémarrez complètement ComfyUI pour qu'il puisse charger le nouveau package.

    Borne
    cd ComfyUI/custom_nodes
git clone https://github.com/PoyoAPI/poyo-comfyui.git
    Continuez quand: La recherche dans le menu des nœuds de PoYo affiche les nœuds PoYo installés.
  3. 3

    Configurez la clé API

    Définissez la clé avant de démarrer ComfyUI ou utilisez la commande de configuration locale. Ne collez pas la clé dans les champs du nœud de workflow.

    Fenêtres
    set POYO_API_KEY=your_poyo_api_key
set POYO_BASE_URL=https://api.poyo.ai
    macOS/Linux
    export POYO_API_KEY=your_poyo_api_key
export POYO_BASE_URL=https://api.poyo.ai
    Alternative de configuration locale
    python -m poyo_nodes.configure
    Continuez quand: Les nœuds PoYo peuvent charger le catalogue de modèles dynamiques sans erreur d'authentification.

Exécutez votre premier workflow PoYo

Utilisez l'exemple officiel afin que l'installation et les informations d'identification soient testées avant de créer un flux de travail plus vaste.

Choisissez un exemple de flux de travail

Commencez par un petit flux de travail qui correspond au comportement que vous souhaitez vérifier.

Comment importer
  1. 1Téléchargez le fichier JSON.
  2. 2Faites-le glisser sur le canevas ComfyUI ou choisissez Workflow → Ouvrir.
  3. 3Sélectionnez un modèle, confirmez les saisies, puis choisissez Queue Prompt.
  1. 1Téléchargez un exemple de flux de travail officiel à partir du référentiel.
  2. 2Ouvrez-le dans ComfyUI et sélectionnez un modèle dans le catalogue en direct.
  3. 3Mettez l'invite en file d'attente et attendez la fin de la tâche PoYo.
  4. 4Recherchez le résultat enregistré sous ComfyUI/output/poyo.

Premier succès: La file d'attente se termine et un résultat généré est disponible dans ComfyUI/output/poyo.

Si quelque chose ne fonctionne pas

Les nœuds PoYo n'apparaissent pas
Redémarrez complètement ComfyUI et inspectez sa console de démarrage pour détecter une erreur d'importation poyo_nodes.
Le catalogue ne se charge pas
Vérifiez la clé API et la connexion réseau, puis redémarrez après avoir modifié les variables d'environnement.
Le workflow ne trouve pas de sortie
Attendez que la tâche atteigne finished, puis vérifiez le nœud Save Result File et ComfyUI/output/poyo.
Détails techniques

Ces détails sont importants pour les intégrations en production, mais ils ne constituent pas une condition préalable à la réussite de la première exécution.

  • Les Credential restent en dehors des fichiers de workflow exportés.
  • Les tâches conservent les statuts publics not_started, running, finished et failed.
  • Les requêtes appellent directement les points de terminaison PoYo REST actuels et incluent une balise X-PoYo-Source.
Créer la clé APIOuvrir le référentiel GitHub