Modelflare Media Skill

A Modelflare Media Skill é uma habilidade de agente instalável: uma pasta com um SKILL.md, uma referência de modelo gerada e um script auxiliar. Uma vez no diretório de habilidades do seu agente, Claude Code, Codex ou qualquer agente que leia SKILL.md sabe escolher uma imagem ou modelo de vídeo Modelflare, cotar seu preço, enviar a solicitação certa, aguardar os vídeos e salvar o resultado.

O pacote é gerado a partir do catálogo de modelos ao vivo a cada poucos minutos, para que a lista de modelos e os preços nunca fiquem obsoletos. Os modelos de texto estão intencionalmente fora do escopo: seu agente já possui um. O script auxiliar precisa apenas do Node.js 18 ou mais recente, que Claude Code e Codex já exigem, e se comporta da mesma forma no macOS, Windows e Linux.

1. Instalar

Você não precisa saber onde seu agente guarda as habilidades; o agente faz. Envie esta mensagem, a mesma para todos os agentes:

Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

Se o agente não conseguir baixar os arquivos, baixe o zip você mesmo e anexe-o à mensagem. Agentes que suportam habilidades (Claude Code, Codex e outros) instalam-no em seu próprio local de habilidades; um agente sem um mecanismo de habilidades ainda pode ler SKILL.md de onde quer que tenha extraído o pacote.

Instalação manual (opcional)

Necessário apenas se você preferir colocar os arquivos sozinho, por exemplo, em uma máquina compartilhada ou em CI.

curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Ambos são instalados em ~/.claude/skills/modelflare-media (no Windows é %USERPROFILE%\.claude\skills), que Claude Code lê como uma habilidade de nível de usuário; uma cópia em nível de projeto vai para .claude/skills/ dentro do repositório. Para outro agente, defina primeiro SKILL_DIR para sua pasta de habilidades (consulte a documentação desse agente para obter o caminho exato).

SKILL_DIR=~/.codex/skills curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

$env:SKILL_DIR = "$HOME\.codex\skills"; irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Você também pode ler SKILL.md diretamente para ver o que o agente seguirá.

2. Dê uma chave ao seu agente

Crie uma chave de API no console e configure-a no ambiente em que seu agente é executado. No macOS e no Linux, adicione a exportação ao seu perfil de shell para mantê-la; no Windows, a segunda linha torna-a persistente.

macOS ou Linux
Windows PowerShell

export MODELFLARE_API_KEY="sk-..."

$env:MODELFLARE_API_KEY = "sk-..."
setx MODELFLARE_API_KEY "sk-..."

Se você não se sentir confortável em definir variáveis de ambiente sozinho, poderá enviar a chave para seu próprio agente confiável em uma sessão privada e solicitar que ele configure o ambiente para você. Trate a chave como uma senha: confirme o que o agente irá escrever e onde, nunca envie para um serviço não confiável ou para um chat, problema, repositório ou ticket público/compartilhado. Peça ao agente para não repetir a chave, salvar uma cópia, colocá-la no código-fonte, prompts, logs ou histórico do shell, nem confirmá-la. Revogue a chave e crie uma nova imediatamente se achar que ela pode ter sido exposta.

A habilidade nunca grava a chave em arquivos ou prompts e nunca a imprime. As contas criadas através do Castaly já possuem uma chave chamada Castaly que roteia todos os grupos desbloqueados; qualquer outra chave com grupos de imagens ou vídeos também funciona.

3. Peça mídia

Fale com seu agente normalmente:

“Gere um pôster 16:9 de um observatório costeiro ao entardecer com gpt-image-2.”
“Transforme este quadro inicial em um vídeo 1080p de 5 segundos com Seedance.”
“Quais modelos de vídeo abaixo de 0,10 USD por segundo podem fazer imagem para vídeo?”

O agente lê SKILL.md, busca o catálogo ativo de https://modelflare.dev/api/pricing para ver quais modelos a chave pode usar e quanto eles custam, depois abre a própria página desse modelo em o site de documentos para obter o corpo exato da solicitação, tabela de parâmetros e limites, e chama a API com seu próprio cliente HTTP. Cada chamada carrega o cabeçalho X-Modelflare-Skill: modelflare-media/1.0, então os logs de uso mostram quais solicitações vieram da habilidade.

4. Da bancada Castaly

Cada geração no Castaly workbench possui um painel “Reproduza isto em seu próprio agente” com a mensagem de instalação, o zip e um resumo da tarefa. Envie a mensagem de instalação uma vez, cole o resumo e o agente reproduzirá o mesmo modelo e parâmetros em sua própria chave.

O que a habilidade não faz

Não diz ao seu agente como trabalhar. Novas tentativas, lotes e o que reportar ficam entre você e seu agente; a habilidade documenta apenas a API.
Não possui lista de modelos própria. O catálogo e cada contrato de solicitação são lidos ao vivo, portanto, um modelo publicado hoje pode ser usado hoje.
Não carrega arquivos para nenhum armazenamento: imagens de referência local são incorporadas na solicitação como URLs de dados, portanto, mantenha-as pequenas (alguns MB).
Não é possível desbloquear grupos de modelos. Se a API responder model_unavailable, esse modelo não estará disponível para esta conta.

Layout do pacote

modelflare-media/
  SKILL.md   authentication, where the live catalog is, how to find each model's
             request contract on the docs site, and what the error codes mean

O pacote não carrega dados de modelo, portanto não fica obsoleto; reinstale apenas para adquirir uma nova versão de habilidade.