Discover available models
Search the current catalog by task intent instead of inventing model IDs from memory.
catalog search
Official PoYo Agent SkillOpen source · Verifiable
Choose the right model. Finish the task safely.
Install poyo-ai-models in your coding agent, connect PoYo through MCP or CLI, and give the agent a reliable path from live model discovery to final delivery.
Use PoYo in Claude Code, Codex, or Cursor
Paste these two lines into your terminal, then ask your agent. The key stays on your machine.
terminal
npx -y @poyoapi/cli auth login npx skills add PoyoAPI/poyo-devtools --skill poyo-ai-models
Pick your agent when the installer asks, then open the agent and say: "Use PoYo to generate an image".
Built for coding agents such as Codex, Claude Code, Cursor, and GitHub Copilot. Not using a coding agent? Open the PoYo creation platform
Tasks you can hand directly to your agent
Every example asks the agent to compare current capabilities and pricing before submitting against the real schema.
Agent request / video
Turn a product image into a short video
“Turn this product image into a five-second ecommerce showcase with a slow push-in and no subject distortion. Compare image-to-video models and pricing before execution.”
Discover image-to-video models → read duration limits → execute → poll task_id
What the Skill does
One compact operating guide covers the four decisions that most often cause model tasks to fail.
Read parameters and pricing
Inspect live schemas, required fields, and public pricing before execution.
schema + pricing
Choose an execution path
Use MCP for agent interaction and the PoYo CLI for scripts and CI jobs.
MCP / CLI
Resume long-running work
Save task_id and distinguish waiting, success, and failure while polling.
check job
A complete task lifecycle, not a list of prompts
The agent moves from discovery to live schema checks, selects an execution path, preserves task state, and reports usable results.
The Skill never replaces PoYo's live catalog, pricing, or task status. It teaches the agent when and how to read them.
agent / poyo-ai-modelsready
01Search modelsFind candidate capabilities in the live Capability Catalog.
02Read the factsCheck schemas, limits, public pricing, and account status.
03Choose the pathUse MCP or CLI based on interaction and automation needs.
04Execute safelySubmit valid parameters and preserve idempotency when needed.
05Resume long jobsSave task_id and continue status checks at sensible intervals.
06Deliver the resultReport model, status, charge information, and final output.
Never call waiting complete
The agent must accurately distinguish pending, running, succeeded, and failed.
Never retry blindly
Check balance and status, and preserve idempotency data and task_id to reduce duplicate charges.
When should you use MCP, CLI, or REST?
After installation, agents still choose MCP or CLI for the environment. Your application services continue to use the REST API directly.
PoYo MCP
Agent conversations and coding clients
Reasoning, discovery, and execution happen together
Explore MCPPoYo CLI
Terminals, scripts, and CI
Reproducible commands, batches, and automation
View GitHubREST API
Product backends and stable application traffic
Direct integration, queue control, or token streaming
Read docsCommon questions
The most common questions, answered with the real product boundaries.
Still have a question? Contact PoYo support→
It is a set of execution instructions for AI agents, covering model discovery, Schema and pricing checks, MCP/CLI selection, long-job recovery, and result reporting. It is not a new model API and does not train anything on your machine.
MCP gives the agent tools; the Skill tells it in which order and under which conditions to use them. MCP alone can execute tasks, but the Skill reduces invented parameters, duplicate submissions, and long-job status mistakes.
Real execution requires an API key. Run npx -y @poyoapi/cli auth login once to save it in your system keyring. Never put the key in prompts, project files, or chat history.
Yes. Setup works the same on Windows. The installer requires Node.js 18+, and PoYo CLI requires Node.js 20+.
Run npx -y @poyoapi/cli account to confirm the key works. If it reports an invalid key, run npx -y @poyoapi/cli auth status: an existing POYO_API_KEY environment variable overrides the saved key. Then reopen the agent so it loads the Skill.
No. The Skill does not change model pricing. Execution is charged according to PoYo's current public pricing and the actual request; the agent should query and explain the basis before running it.
Install the PoYo Skill and run your first task
Create an API key, install the official Skill, and describe the outcome. One verifiable workflow handles model selection, parameter checks, and long-job recovery.