Descubra os modelos disponíveis
Pesquise o catálogo atual por intenção de tarefa em vez de inventar IDs de modelo a partir da memória.
pesquisa de catálogo
PoYo Agent Skill oficialCódigo aberto · Verificável
Escolha o modelo certo. Conclua a tarefa com segurança.
Instale poyo-ai-models no seu agente de programação, conecte a PoYo via MCP ou CLI e siga um caminho confiável da descoberta de modelos à entrega.
Use a PoYo no Claude Code, Codex ou Cursor
Cole estas duas linhas no terminal e depois peça ao seu agente. A chave fica só no seu computador.
terminal
npx -y @poyoapi/cli auth login npx skills add PoyoAPI/poyo-devtools --skill poyo-ai-models
Escolha seu agente quando o instalador perguntar, depois abra o agente e diga: "Use a PoYo para gerar uma imagem".
Criado para agentes de programação como Codex, Claude Code, Cursor e GitHub Copilot. Não usa um agente de programação? Abra a plataforma de criação da PoYo
Tarefas que você pode entregar diretamente ao seu Agent
Cada exemplo pede ao agente para comparar os recursos e preços atuais antes de enviar com o esquema real.
Solicitação do agente / video
Transforme uma imagem de produto em um vídeo curto
“Transforme esta imagem do produto em uma vitrine de comércio eletrônico de cinco segundos com um push-in lento e sem distorção de assunto. Compare modelos de imagem para vídeo e preços antes da execução.”
Descobrir modelos de imagem para vídeo → verificar limites de duração → executar → consultar task_id
O que o Skill faz
Um guia compacto cobre as quatro decisões que mais causam falhas nas tarefas com modelos.
Ler parâmetros e preços
Inspecione esquemas ao vivo, campos obrigatórios e preços públicos antes da execução.
esquema + preços
Escolha um caminho de execução
Use MCP para interação do agente e o PoYo CLI para scripts e trabalhos CI.
MCP / CLI
Retomar o trabalho de longa duração
Salve o task_id e diferencie espera, sucesso e falha ao consultar o status.
verificar trabalho
Um ciclo completo de tarefas, não uma lista de prompts
O agente descobre modelos, consulta Schemas atuais, escolhe a execução, preserva o estado e entrega resultados úteis.
O Skill nunca substitui o catálogo, os preços ou o status das tarefas ao vivo da PoYo. Ele ensina o agente quando e como consultá-los.
agent / poyo-ai-modelsready
01Pesquisar modelosEncontre recursos compatíveis no Capability Catalog em tempo real.
02Leia os fatosVerifique esquemas, limites, preços públicos e status da conta.
03Escolha o caminhoUse MCP ou CLI com base nas necessidades de interação e automação.
04Execute com segurançaEnvie parâmetros válidos e preserve a idempotência quando necessário.
05Retomar trabalhos longosSalve o task_id e continue as verificações de status em intervalos razoáveis.
06Entregar o resultadoInforme o modelo, o status, a cobrança e a saída final.
Nunca trate uma tarefa em espera como concluída
O Agent deve distinguir corretamente os estados pending, running, succeeded e failed.
Nunca tente novamente às cegas
Verifique o saldo e o status e preserve os dados de idempotência e o task_id para reduzir as cobranças duplicadas.
Quando usar MCP, CLI ou REST API?
Após a instalação, o Agent escolhe MCP ou CLI conforme o ambiente. Seus serviços continuam usando a REST API diretamente.
PoYo MCP
Conversas com agentes e clientes de codificação
Raciocínio, descoberta e execução acontecem juntos
Ver MCPPoYo CLI
Terminais, scripts e CI
Comandos, lotes e automação reproduzíveis
Ver GitHubREST API
Backends de produtos e tráfego estável de aplicativos
Integração direta, controle de fila ou streaming de token
Ver documentaçãoPerguntas frequentes
As perguntas mais comuns, respondidas com os limites reais do produto.
Ainda tem alguma dúvida? Entre em contato com o suporte PoYo→
É um conjunto de instruções de execução para agentes de IA, abrangendo descoberta de modelos, verificação de Schema e preços, escolha entre MCP e CLI, recuperação de trabalhos longos e entrega de resultados. Não é uma nova API de modelo e não treina nada na sua máquina.
O MCP fornece as ferramentas do agente; o Skill informa em que ordem e sob quais condições usá-las. O MCP sozinho pode executar tarefas, mas o Skill reduz parâmetros inventados, envios duplicados e erros de status de trabalho longo.
A execução real exige uma chave de API. Execute uma vez npx -y @poyoapi/cli auth login para salvá-la no chaveiro do sistema. Nunca coloque a chave em pedidos, arquivos do projeto ou históricos de chat.
Sim. A configuração é igual no Windows. O instalador exige Node.js 18+ e o PoYo CLI exige Node.js 20+.
Execute npx -y @poyoapi/cli account para confirmar que a chave funciona. Se ela aparecer como inválida, execute npx -y @poyoapi/cli auth status: uma variável de ambiente POYO_API_KEY existente tem prioridade sobre a chave salva. Depois reabra o agente para que ele carregue o Skill.
Não. O Skill não altera o preço do modelo. A execução é cobrada de acordo com o preço público atual do PoYo e a solicitação real; o agente deve consultar e explicar a base antes de executá-lo.
Instale o PoYo Skill e execute sua primeira tarefa
Crie uma API Key, instale o Skill oficial e descreva o resultado desejado. Um fluxo de trabalho verificável cuida da seleção de modelos, da validação de parâmetros e da recuperação de trabalhos longos.