A API GPT Image 2.5 já está disponível. Crie e edite imagens →
PoYoPoYo
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.

$npx skills add PoyoAPI/poyo-devtools --skill poyo-ai-models
Iniciar configuração guiadaVer fonte

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

Conclua a configuração básica em quatro etapas

Escolha cliente e escopo, configure a API Key e execute uma verificação somente leitura.

1

Verifique o ambiente e escolha um cliente

  • O instalador requer Node.js 18 ou superior.
  • O PoYo CLI requer Node.js 20 ou superior.

Cliente de programação

2

Instale o Skill oficial

Adicione poyo-ai-models a um cliente de codificação que suporte Agent Skills.

Escolha onde instalar

Escolha primeiro um cliente para gerar um comando seguro e determinístico.

Após a instalação, recarregue ou reinicie o cliente para que ele detecte o Skill.

3

Configure uma API Key da PoYo

Use uma variável de ambiente ou o gerenciador de segredos do cliente. Nunca coloque a chave em um prompt ou repositório.

Abrir API Keys

Configure sua API Key

$export POYO_API_KEY="your_api_key"

Este comando afeta apenas a sessão atual do terminal. Para manter a configuração, use o gerenciador de segredos do cliente e nunca faça commit da chave.

4

Verifique sem uma tarefa paga

Confirme o Skill e o caminho de execução e consulte apenas modelos, entradas e preços públicos.

Confirme que poyo-ai-models está carregado e informe se usará PoYo hosted MCP ou PoYo CLI. Consulte apenas modelos de imagem atuais, requisitos de entrada e preços públicos. Não envie uma tarefa paga.

O que o agente deve confirmar

  • poyo-ai-models está carregado e disponível.
  • Há um caminho pronto: PoYo MCP ou PoYo CLI.
  • O agente retorna apenas modelos atuais, requisitos de entrada e preços públicos, sem enviar uma tarefa paga.

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.

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

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 MCP

PoYo CLI

Terminais, scripts e CI

Comandos, lotes e automação reproduzíveis

Ver GitHub

REST API

Backends de produtos e tráfego estável de aplicativos

Integração direta, controle de fila ou streaming de token

Ver documentação

Perguntas frequentes

As perguntas mais comuns, respondidas com os limites reais do produto.

Ainda tem alguma dúvida? Entre em contato com o suporte PoYo→

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.

Criar uma API KeyVer código-fonte do Skill