ComposioHQ/Replicate-Automation

Automação do Replicate

Automatize seus fluxos de trabalho com modelos de IA do Replicate — execute predições em qualquer modelo público (geração de imagens, LLMs, áudio, vídeo), faça upload de arquivos de entrada, inspecione esquemas e documentação de modelos, liste versões de modelos e acompanhe o histórico de predições.

Documentação do kit de ferramentas: composio.dev/toolkits/replicate

---

Configuração

1. Adicione o servidor MCP do Composio ao seu cliente: https://rube.app/mcp
2. Conecte sua conta do Replicate quando solicitado (autenticação por token de API)
3. Comece a usar os fluxos de trabalho abaixo

---

Fluxos de Trabalho Principais

1. Obter Detalhes e Esquema do Modelo

Use REPLICATE_MODELS_GET para inspecionar o esquema de entrada/saída de um modelo antes de executar predições.

Ferramenta: REPLICATE_MODELS_GET
Entradas:
  - model_owner: string (obrigatório) — ex.: "meta", "black-forest-labs", "stability-ai"
  - model_name: string (obrigatório) — ex.: "meta-llama-3-8b-instruct", "flux-1.1-pro"

Importante: Cada modelo possui chaves e tipos de entrada únicos. Sempre verifique openapi_schema nesta resposta antes de construir entradas de predição.

2. Executar uma Predição

Use REPLICATE_MODELS_PREDICTIONS_CREATE para executar inferência em qualquer modelo, com espera síncrona opcional e webhooks.

Ferramenta: REPLICATE_MODELS_PREDICTIONS_CREATE
Entradas:
  - model_owner: string (obrigatório) — ex.: "meta", "black-forest-labs"
  - model_name: string (obrigatório) — ex.: "flux-1.1-pro", "sdxl"
  - input: objeto (obrigatório) — entradas específicas do modelo, ex.: { "prompt": "Um pôr do sol sobre montanhas" }
  - wait_for: inteiro (1-60 segundos, opcional) — espera síncrona pela conclusão
  - cancel_after: string (opcional) — tempo máximo de execução, ex.: "300s", "5m"
  - webhook: string (opcional) — URL HTTPS para notificações assíncronas de conclusão
  - webhook_events_filter: array (opcional) — ["start", "output", "logs", "completed"]

Síncrono vs Assíncrono: Use wait_for (1-60s) para modelos rápidos. Para tarefas longas, omita-o e use webhooks ou consulte via REPLICATE_PREDICTIONS_LIST.

3. Fazer Upload de Arquivos para Entrada do Modelo

Use REPLICATE_CREATE_FILE para fazer upload de imagens, documentos ou outras entradas binárias que os modelos precisam.

Ferramenta: REPLICATE_CREATE_FILE
Entradas:
  - content: string (obrigatório) — conteúdo do arquivo codificado em base64
  - filename: string (obrigatório) — ex.: "input.png", "audio.wav" (máx. 255 bytes UTF-8)
  - content_type: string (padrão "application/octet-stream") — tipo MIME
  - metadata: objeto (opcional) — metadados JSON personalizados

4. Ler Documentação do Modelo

Use REPLICATE_MODELS_README_GET para acessar o README de um modelo no formato Markdown, para instruções detalhadas de uso.

Ferramenta: REPLICATE_MODELS_README_GET
Entradas:
  - model_owner: string (obrigatório)
  - model_name: string (obrigatório)

5. Listar Versões do Modelo

Use REPLICATE_MODELS_VERSIONS_LIST para ver todas as versões disponíveis de um modelo, ordenadas da mais recente para a mais antiga.

Ferramenta: REPLICATE_MODELS_VERSIONS_LIST
Entradas:
  - model_owner: string (obrigatório)
  - model_name: string (obrigatório)

6. Rastrear Histórico de Predições e Arquivos

Use REPLICATE_PREDICTIONS_LIST para recuperar o histórico de predições, e REPLICATE_FILES_GET/REPLICATE_FILES_LIST para gerenciar arquivos enviados.

Ferramenta: REPLICATE_PREDICTIONS_LIST
  - Lista todas as predições do usuário autenticado com paginação

Ferramenta: REPLICATE_FILES_LIST
  - Lista arquivos enviados, do mais recente ao mais antigo

Ferramenta: REPLICATE_FILES_GET
  - Obtém detalhes de um arquivo específico por ID

---

Armadilhas Conhecidas

Armadilha	Detalhe
Chaves de entrada específicas do modelo	Cada modelo possui chaves e tipos de entrada únicos. Usar a chave errada causa erros de validação. Sempre chame REPLICATE_MODELS_GET primeiro para verificar o openapi_schema.
Codificação de upload de arquivos	REPLICATE_CREATE_FILE requer conteúdo codificado em base64. Arquivos binários tratados como texto (UTF-8) falharão com erros de decodificação.
Caminhos públicos vs de implantação	Modelos públicos devem ser executados via REPLICATE_MODELS_PREDICTIONS_CREATE. Usar caminhos voltados para implantação causa falhas HTTP 404.
Limites de espera síncrona	wait_for suporta apenas 1-60 segundos. Tarefas longas precisam de tratamento assíncrono via webhooks ou consulta a REPLICATE_PREDICTIONS_LIST.
Restrições de modelos de imagem	Modelos de imagem como flux-1.1-pro têm restrições específicas (ex.: largura/altura máximas de 1440px, proporções de aspecto válidas). Verifique o esquema do modelo primeiro.
Referências a arquivos desatualizados	O uso intenso cria muitos uploads. Verifique rotineiramente REPLICATE_FILES_LIST para evitar usar referências file_id desatualizadas.

---

Referência Rápida

Slug da Ferramenta	Descrição
REPLICATE_MODELS_GET	Obter detalhes, esquema e metadados do modelo
REPLICATE_MODELS_PREDICTIONS_CREATE	Executar uma predição em um modelo
REPLICATE_CREATE_FILE	Fazer upload de um arquivo para entrada do modelo
REPLICATE_MODELS_README_GET	Obter documentação README do modelo
REPLICATE_MODELS_VERSIONS_LIST	Listar todas as versões de um modelo
REPLICATE_PREDICTIONS_LIST	Listar histórico de predições com paginação
REPLICATE_FILES_LIST	Listar arquivos enviados
REPLICATE_FILES_GET	Obter detalhes do arquivo por ID

---

Fornecido por Composio