PoYo CLI

Run the CLI without a global installation:

npx -y @poyoapi/cli help

The examples below use the shorter poyo command. Install it globally first, or replace poyo with npx -y @poyoapi/cli:

npm install --global @poyoapi/cli

Authentication

npx -y @poyoapi/cli auth login
npx -y @poyoapi/cli auth status

Credential priority is:

--api-key
POYO_API_KEY
System keyring
Local config fallback

Prefer the environment or keyring so the key does not enter shell history.

Discover models

poyo models
poyo models image
poyo describe MODEL_ID

Chat

poyo chat MODEL_ID \
  --protocol openai-chat \
  --input '{"messages":[{"role":"user","content":"Hello"}]}'

Stream chat tokens:

poyo chat MODEL_ID \
  --protocol anthropic \
  --stream \
  --input-file request.json

Supported protocol values are openai-chat, openai-responses, anthropic, and gemini. Text is printed incrementally by default; use --format jsonl to preserve raw SSE event JSON.

Generation

poyo run MODEL_ID --input '{"prompt":"A mountain lake"}'
poyo submit MODEL_ID --input-file request.json
poyo task get TASK_ID
poyo task wait TASK_ID --timeout 300

run submits and waits. submit returns immediately unless --wait is provided.

stdio MCP

poyo mcp
poyo mcp --models flux-schnell,tripo3d-h3.1-text-to-3d

See Choose MCP tools before exposing category or model-specific tools.

Output

Use --format table|json|jsonl|csv and optionally --output FILE.

Get started

Clients

PoYo CLI

PoYo CLI

Authentication

Discover models

Chat

Generation

stdio MCP

Output

​PoYo CLI

​Authentication

​Discover models

​Chat

​Generation

​stdio MCP

​Output

PoYo CLI

Authentication

Discover models

Chat

Generation

stdio MCP

Output