Pular para o conteúdo principal

MCP e agentes

Deixe seu assistente de IA criar imagens e vídeo

O servidor MCP oficial oferece ao Claude, Cursor, Codex, VS Code e outros assistentes o catálogo atual de modelos, estimativas exatas de preço e a criação de tarefas. Você pede com suas palavras, e ele aguarda sua confirmação antes de qualquer cobrança.

Criar uma chave de APIGuia completo na documentação

O que é um servidor MCP?

O MCP (Model Context Protocol) é um padrão para dar novas ferramentas a um assistente de IA. Adicione o servidor da SpicyAPI e seu assistente passa a ver modelos, conferir preços e criar imagens ou vídeo para você.

  1. Você e seu assistenteClaude, Cursor, Codex, VS Code…
  2. Servidor MCP da SpicyAPIRoda no seu computador via npx
  3. Modelos de imagem e vídeoCatálogo ao vivo, preços exatos
O assistente decide qual ferramenta chamar. Tudo que custa dinheiro para e espera o seu sim.

Ideal para

  • Assets enquanto você programaPeça uma imagem de capa ou um clipe do produto sem sair do editor.
  • Explorar modelosPergunte qual modelo serve para o trabalho e quanto vai custar.
  • Lotes sem esforçoDeixe o agente criar, esperar e juntar várias tarefas.

O que acontece quando você pede

  1. Passo 1Encontra um modelo adequado no catálogo atual e lê as entradas que ele aceita
  2. Passo 2Envia o seu arquivo local, se houver
  3. Passo 3Obtém uma estimativa exata de preço em dólares americanos e pede sua confirmação antes de qualquer cobrança
  4. Passo 4Inicia a tarefa, espera terminar e entrega o link do resultado
Exemplo de sessão

  1. Você: Transforme beach.jpg em um clipe de seis segundos de ondas ao pôr do sol.

  2. spicyapi_models_listspicyapi_model_get
    Assistente: Achei um modelo de vídeo que aceita imagem inicial
  3. spicyapi_upload_file
    beach.jpg enviado
  4. spicyapi_task_quote

    Aqui está o preço exato em dólares. Criar a tarefa?

  5. spicyapi_task_createspicyapi_task_wait
    Pronto. Aqui está o seu link de download.
Ilustração de uma sessão típica. Nada é cobrado até você aprovar.

Adicione ao seu assistente

Todos os clientes rodam o mesmo servidor local via npx. Escolha o seu para ver o comando ou o bloco de configuração exato.

{
  "mcpServers": {
    "spicyapi": {
      "command": "npx",
      "args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
      "env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
    }
  }
}

Um único servidor stdio para todos os clientes MCP. Cole o bloco no arquivo de configuração do cliente.

Clientes de terceiros mudam o formato de configuração entre versões. Se um trecho daqui deixar de bater com o cliente, vale a documentação dele.

Usa o Claude? Gere imagens e vídeos direto no Claude →

Ferramentas que ele expõe

As ferramentas somente leitura são grátis. As duas que gastam dinheiro e a que apaga conteúdo sempre pedem confirmação antes.

GrátisGrátis e somente leitura12

  • spicyapi_service_statusVerificação de status pública, sem chave
  • spicyapi_docs_searchBuscar na documentação incluída
  • spicyapi_models_listModelos ativos e os seus preços
  • spicyapi_model_getUm modelo e seu schema de entrada
  • spicyapi_balance_getSaldo disponível, retido e total
  • spicyapi_usage_getQuanto a chave atual já gastou
  • spicyapi_tasks_listTarefas recentes da chave atual
  • spicyapi_task_getUma tarefa, com os links de resultado prontos
  • spicyapi_task_waitAguardar até 5 minutos uma tarefa terminar
  • spicyapi_task_quoteCalcular o preço de uma requisição exata sem criá-la
  • spicyapi_upload_fileEnviar um arquivo local para usar como entrada
  • spicyapi_download_url_createUm novo link de download para um resultado

Pede confirmação antes de cobrarPede confirmação antes de rodar3

  • spicyapi_task_createIniciar uma tarefa de geração
  • spicyapi_task_retryExecutar de novo uma tarefa que falhou ou expirou
  • spicyapi_task_purgeApagar de vez o conteúdo de uma tarefa concluída
Abrir pacoteVer código-fonte

Adicione o Agent Skill para a ordem das chamadas

O servidor MCP dá capacidades ao agente; o Agent Skill ensina como usá-las: ler o schema, confirmar a estimativa de preço e reutilizar uma única chave de idempotência por tentativa. Claude Code e Codex aceitam os dois.

Abrir pacoteVer código-fonte
npx skills add spicyapi-ai/spicy-skill \
  --agent claude-code

Arquivos que seu agente pode ler

Esses arquivos levam assistentes e ferramentas à descrição do produto, ao catálogo e à documentação oficial.

agent.md

Contrato compacto de integração e limites de segurança para agentes.

/agent.md →

llms.txt

Índice selecionado do site e dos modelos para recuperação por IA.

/llms.txt →

llms-full.txt

Contexto ampliado de produto, workflows, endpoints e descoberta.

/llms-full.txt →

Manifesto do agente

Descoberta JSON estruturada para ferramentas e clientes autônomos.

/api/agent →

Corrija os erros mais comuns

A maioria dos problemas de primeira viagem é um destes três. Cada card mostra o que você vê e a única coisa a mudar.

  • ferram.

    As ferramentas não aparecem

    Reinicie o assistente depois de editar a configuração e confira se o JSON é válido.

  • chave

    Chave de API ausente

    Coloque SPICY_API_KEY no bloco env da configuração do servidor. Apps de desktop não enxergam uma chave exportada no seu shell.

  • confirmar

    Não consigo criar tarefas

    Seu cliente não consegue exibir pedidos de confirmação. As ferramentas gratuitas continuam funcionando; para criar tarefas, use um cliente com suporte a elicitation do MCP.

Perguntas frequentes