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

PoYo MCP Server

Tous les modèles PoYo, dans votre Agent IA.

Connectez-vous une seule fois pour permettre à Codex, Claude Code, Cursor et VS Code de rechercher des modèles d’image, de vidéo, d’audio, de chat et de 3D, de consulter les Schema et les tarifs publics à jour, puis d’exécuter des tâches via PoYo.

MCP est une connexion sécurisée qui permet à votre Agent IA d’utiliser les modèles PoYo sans écrire vous-même de requêtes API.

npx -y @poyoapi/mcp

Bridge stdio local pour VS Code ou les clients limités à stdio. Nécessite Node.js 20+ ; utilisez la configuration guidée ci-dessous.

Créer une API KeyVoir la configurationConsulter la documentation MCP

Configuration

Connectez-vous en trois étapes. Ouvrez la configuration avancée uniquement pour limiter des catégories ou des modèles.

1

Préparez votre API Key

Créez d’abord une PoYo API Key. Le client l’utilisera lors de la connexion.

Ne placez jamais une véritable API Key dans un fichier de configuration partagé ou une URL.

Créer une API Key
2

Choisissez un client et trouvez sa configuration

Sélectionnez l’application utilisée pour n’afficher qu’un emplacement pertinent.

Point d’entrée recommandé

Ouvrez les réglages de Codex, choisissez MCP servers, puis Add server et Streamable HTTP.

Voir les instructions officielles du client

Fichier de configuration manuelle

~/.codex/config.toml

S’applique à

Tous les projets de l’utilisateur actuel

Ouvrez la configuration MCP dans le client. S’il n’existe pas d’entrée visuelle, ouvrez ou créez le fichier ci-dessus.

Les chemins commençant par ./ se trouvent dans le projet ouvert. Créez le dossier ou le fichier si nécessaire.

3

Ajoutez la configuration et vérifiez

Copiez la configuration du client choisi, rechargez MCP et effectuez une vérification gratuite.

Fusionnez la configuration existante, ne l’écrasez pas

Si le fichier contient déjà d’autres MCP Server, fusionnez uniquement l’entrée poyo et préservez tout le contenu existant.

Ajoutez la configuration suivante à ~/.codex/config.toml

[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45

Enregistrez votre API Key dans la variable d’environnement POYO_API_KEY avant de lancer le client. Après l’enregistrement, démarrez une nouvelle session Codex pour recharger la configuration MCP.

Comment définir POYO_API_KEY ?

Copiez la commande adaptée à votre système, remplacez your_api_key par la véritable Key et lancez le client depuis la même session de terminal.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Ces commandes ne s’appliquent qu’à la session de terminal actuelle. Ne placez pas la véritable Key dans les fichiers du projet, les captures ou les journaux publics.

Consulter la documentation MCP
Laisser votre Agent aider à la configuration

Copiez un Prompt à portée limitée qui préserve les réglages existants, garde la vraie Key hors des fichiers et affiche le diff avant toute écriture.

Vérifiez la connexion

Contrôlez ces états dans l’ordre. Aucun ne lance de tâche de modèle payante.

  1. 1Les outils PoYo apparaissent dans le client : la configuration est chargée.
  2. 2poyo_account renvoie le compte : l’API Key fonctionne.
  3. 3poyo_search_models renvoie des modèles : le catalogue est accessible.
La connexion ne fonctionne pas ?
  • Aucun outil : vérifiez l’emplacement du fichier puis rechargez le MCP Server.
  • Échec du compte : vérifiez POYO_API_KEY puis relancez le client depuis le même environnement.
  • Échec de connexion : vérifiez https://api.poyo.ai/mcp et que le réseau ou le proxy autorise HTTPS.

Lorsque les outils, le compte et le catalogue sont validés, PoYo MCP est connecté.

Que peut faire un Agent avec PoYo MCP ?

Décrivez une tâche en langage naturel. L’Agent recherche un modèle adapté, lit ses entrées et son prix, l’exécute, puis renvoie le résultat lorsque la tâche longue est terminée.

Découvrir des modèles

Rechercher les modèles actuels d’image, de vidéo, d’audio, de chat ou de 3D à partir d’une tâche en langage naturel

poyo_search_models
Modèles candidats

Lire les entrées

Lire le Schema d’entrée, les exemples, les protocoles et les capacités actuels

poyo_get_model_schema
Entrées valides

Vérifier les tarifs

Lire le tarif public actuel avant de lancer une requête payante

poyo_get_pricing
Confirmation du prix

Exécuter des tâches courtes

Terminer les tâches de chat ou de génération qui répondent après une courte attente

poyo_chatpoyo_run_model
Résultat complet

Poursuivre les tâches longues

Soumettre une tâche longue, conserver son task_id, puis lire son état et ses sorties plus tard

poyo_submit_jobpoyo_check_job
État et sortie

Consulter le compte

Lire les informations actuelles du compte et des crédits avant d’exécuter un modèle

poyo_account
État du compte

Quand utiliser MCP, CLI ou la REST API ?

Utilisez MCP lorsqu’un Agent doit choisir et appeler des modèles, PoYo CLI pour l’automatisation en terminal ou CI, et la REST API pour le trafic applicatif ou la sortie token par token.

01

Assistant IA ou Agent de codage

Choix

MCP

Streamable HTTP

Pourquoi ce choix convient

Permettre à un Agent de découvrir des modèles, de lire les Schema et les tarifs, puis d’appeler des outils dans un éditeur ou une conversation.

Ce que vous contrôlez

Périmètre des outils et autorisations du client

Consulter la documentation
02

Scripts de terminal ou CI

Choix

PoYo CLI

@poyoapi/cli

Pourquoi ce choix convient

Découvrir des modèles, lancer une génération, attendre les tâches et produire du JSON, JSONL ou CSV depuis un shell.

Ce que vous contrôlez

Options de commande, fichiers d’entrée et format de sortie

Consulter la documentation
03

Backend de votre application

Choix

REST API

HTTP + JSON / SSE

Pourquoi ce choix convient

Gérer le trafic applicatif, le streaming de tokens, le polling, les webhooks et les tâches par lots.

Ce que vous contrôlez

Cycle de vie de la requête et expérience produit

Consulter la documentation

Questions fréquentes

Comprenez les connexions MCP, les API Key, le périmètre des outils, la facturation et la reprise des tâches longues.

Créez une API Key, suivez la documentation MCP pour ajouter PoYo à votre client, puis vérifiez votre compte, le Schema du modèle et le tarif public.

Créer une API KeyConsulter la documentation MCP