---
title: Use Luma no WorkBuddy via RunAPI — Guia de Vídeo MCP | RunAPI
description: Modifique vídeos com Luma Ray 3.2 no WorkBuddy através do servidor MCP do RunAPI. Transformações guiadas por prompt com coerência espacial, uma API key.
url: https://runapi.ai/pt-BR/workbuddy-luma.md
canonical: https://runapi.ai/pt-BR/workbuddy-luma
locale: pt-BR
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/workbuddy-luma
  zh-CN: https://runapi.ai/zh-CN/workbuddy-luma
  es: https://runapi.ai/es/workbuddy-luma
  ja: https://runapi.ai/ja/workbuddy-luma
  de: https://runapi.ai/de/workbuddy-luma
  fr: https://runapi.ai/fr/workbuddy-luma
  pt-BR: https://runapi.ai/pt-BR/workbuddy-luma
  ko: https://runapi.ai/ko/workbuddy-luma
  it: https://runapi.ai/it/workbuddy-luma
  nl: https://runapi.ai/nl/workbuddy-luma
  pl: https://runapi.ai/pl/workbuddy-luma
  tr: https://runapi.ai/tr/workbuddy-luma
  zh-TW: https://runapi.ai/zh-TW/workbuddy-luma
  zh-HK: https://runapi.ai/zh-HK/workbuddy-luma
  ar: https://runapi.ai/ar/workbuddy-luma
  x-default: https://runapi.ai/workbuddy-luma
model: luma
---

> HTML version: https://runapi.ai/pt-BR/workbuddy-luma
> Site index for agents: https://runapi.ai/llms.txt


# Use Luma no WorkBuddy.

O Luma Ray 3.2 modifica vídeos existentes com transformações guiadas por prompt que preservam a coerência espacial e a estrutura de cena 3D. O WorkBuddy fala MCP nativamente — adicione o RunAPI como servidor MCP uma vez, depois entregue ao agente do workbench uma URL de vídeo de origem e descreva a transformação. Ele chama a ferramenta do Luma, aguarda a tarefa assíncrona e retorna o vídeo re-renderizado com iluminação atmosférica e movimento de câmera fisicamente consistente.

- [Obter API Key](https://runapi.ai/pt-BR/login)
- [Ler a documentação](https://runapi.ai/pt-BR/docs/guides)

um servidor MCP · uma chave RunAPI · gerenciamento de tarefas assíncronas

### Prompt

```text
Modify a video with Luma Ray 3.2 through the runapi MCP server.

Requirements:
- Use the runapi MCP server's video modification tool.
- Set model to "luma-modify-video".
- Source video: https://example.com/park-walk.mp4
- Transformation: "Transform the scene into a foggy autumn morning
  with golden light filtering through trees".
- The task is async — wait for it to complete and give me the modified video URL.

```

### Configuração MCP

```bash
{
  "mcp_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": {
        "Authorization": "Bearer $RUNAPI_API_KEY"
      }
    }
  }
}

```

### Resposta

```json
{
  "task_id": "tsk_abc123",
  "status": "completed",
  "model": "luma-modify-video",
  "output": {
    "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4"
  }
}

```

## Use Luma no WorkBuddy em três etapas

1. **Adicione o servidor MCP do RunAPI** - Registre o RunAPI como servidor MCP chamado runapi apontando para https://runapi.ai/mcp, com o cabeçalho Authorization lendo sua chave de RUNAPI_API_KEY. Se você já conectou o RunAPI ao WorkBuddy, o mesmo servidor expõe a ferramenta do Luma — nenhuma configuração extra necessária. `{
  "mcp_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" }
    }
  }
}
`
2. **Instrua o agente da bancada de trabalho** - Forneça ao WorkBuddy uma URL de vídeo de origem e descreva a transformação em linguagem natural — atmosfera, iluminação, estilo ou edições de cena. O agente mapeia sua solicitação para a ferramenta Luma modify_video com model definido como luma-modify-video, e o Luma preserva a geometria original da cena enquanto aplica as alterações. `Restyle https://example.com/park-walk.mp4 with Luma:
a foggy autumn morning with golden light filtering through trees.
`
3. **Receba o vídeo modificado** - A tarefa do Luma é assíncrona. O WorkBuddy faz polling pelo servidor MCP até que o status seja completed, depois publica a URL do vídeo re-renderizado na sua conversa. O tempo de processamento típico é de 30 a 120 segundos, dependendo da complexidade. `{
  "task_id": "tsk_abc123",
  "status": "completed",
  "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" }
}
`

## Parâmetros da ferramenta Luma modify_video

| Parâmetro | Tipo | Descrição |
| --- | --- | --- |
| `model` | `string` | Obrigatório. Use luma-modify-video. |
| `prompt` | `string` | Obrigatório. Descrição em texto da transformação de vídeo desejada — mudanças de estilo, iluminação, atmosfera ou edições de cena. |
| `source_video_url` | `string` | Obrigatório. URL do vídeo de origem a ser modificado. Deve ser um arquivo MP4 ou MOV acessível publicamente. |
| `watermark` | `boolean` | Opcional. Se deve adicionar uma marca d'água ao vídeo de saída. |
| `callback_url` | `string` | Opcional. URL de webhook que recebe um POST quando a tarefa é concluída. |
| `task_id` | `string` | Retornado pela ferramenta. O WorkBuddy o usa para fazer polling da tarefa assíncrona até que o vídeo modificado esteja pronto. |

## O que é Luma no WorkBuddy?

O Luma Ray 3.2 (Dream Machine) é especializado em modificar vídeos existentes com uma qualidade onírica que os usuários descrevem como cinematográfica e ágil para iterar. Em vez de gerar do zero, ele re-renderiza filmagens de origem com transformações guiadas por prompt — mudanças atmosféricas, conversões de estilo e alterações ambientais — mantendo o layout espacial original e o movimento de câmera intactos. O WorkBuddy o acessa através do servidor MCP do runapi, o mesmo servidor e RUNAPI_API_KEY que alimentam todos os outros modelos no workbench.

## Casos de uso do Luma

- **Peças de atmosfera e estética de videoclipe** - Peça ao WorkBuddy para transformar filmagens brutas em peças estilizadas com a qualidade visual onírica do Luma. Mude iluminação, atmosfera e paleta de cores preservando o movimento original para conceitos de videoclipes ou projetos artísticos.
- **Hipóteses visuais rápidas para direções de anúncios** - Reestilize um vídeo de produto existente em múltiplas direções visuais — cinematográfica, minimalista, noir ou sazonal — em uma única conversa no workbench, para testar qual visual funciona antes de comprometer com uma regravação completa.
- **Footage base para pipelines com múltiplas ferramentas** - Use o Luma para reestilizar filmagens geradas ou gravadas, depois deixe o WorkBuddy passar o resultado para outras ferramentas de vídeo do RunAPI na mesma sessão. O tempo de resposta rápido do Luma o torna prático como etapa de estilização em um pipeline de vídeo maior.

## Perguntas sobre Luma + WorkBuddy

### Que tipo de transformações o Luma pode fazer no WorkBuddy?

O Luma modify_video re-renderiza filmagens existentes com alterações guiadas por prompt — mudanças atmosféricas (névoa, chuva, hora dourada), transferências de estilo (cinematográfico, anime, noir), reformulações de iluminação e transformações ambientais. Preserva o movimento de câmera e o layout espacial originais, e o WorkBuddy conduz tudo a partir de um prompt em linguagem natural.

### O que diferencia o Luma dos outros modelos de vídeo no RunAPI?

O Luma é especializado em modificar vídeos existentes em vez de gerar do zero. Seu modelo Ray 3.2 mantém a coerência espacial 3D durante as transformações, então os objetos preservam suas relações de profundidade e o movimento de câmera permanece fisicamente consistente. Modelos como Kling ou Hailuo geram novos vídeos a partir de texto ou imagens — todos acessíveis pelo mesmo servidor MCP do runapi.

### O WorkBuddy aguarda o resultado, ou eu faço o polling manualmente?

O agente do workbench cuida disso. As tarefas do Luma são assíncronas — a ferramenta retorna um task_id e o WorkBuddy faz polling da tarefa pelo servidor MCP até que o status seja completed, depois publica a URL do vídeo modificado na sua conversa. O tempo de processamento típico é de 30 a 120 segundos.

### Quanto custa a modificação de vídeo do Luma no RunAPI?

O Luma usa cobrança fixa por tarefa — cada chamada modify_video tem um custo fixo independentemente da duração do vídeo. Consulte a página de preços do RunAPI para valores atuais. Gerações com falha não são cobradas.

### Posso encadear o Luma com outros modelos de vídeo do RunAPI em uma sessão do WorkBuddy?

Sim. Peça ao WorkBuddy para gerar um vídeo com Kling ou Hailuo, depois passe a URL de saída como source_video_url para o Luma modify_video no pós-processamento — tudo pelo mesmo servidor MCP do runapi e RUNAPI_API_KEY, em uma única conversa.


- [Guia de configuração do WorkBuddy →](https://runapi.ai/pt-BR/workbuddy.md) - Ainda não conectado? Comece com o guia de configuração do RunAPI MCP para WorkBuddy.
- [Luma no RunAPI →](https://runapi.ai/pt-BR/models/luma.md) - Veja variantes do Luma, preços e documentação da API.

## Experimente o Luma no WorkBuddy hoje.

Obtenha uma chave RunAPI gratuita, adicione o servidor MCP ao WorkBuddy e comece a modificar vídeos com as transformações espaciais do Luma Ray 3.2 sem sair do workbench.

[Explorar modelos →](https://runapi.ai/pt-BR/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/pt-BR/.md)
### Produto
- [Catálogo de modelos](https://runapi.ai/pt-BR/models.md)
- [Preços](https://runapi.ai/pt-BR/pricing.md)
- [Provedores](https://runapi.ai/pt-BR/models#all-models)
### Desenvolvedores
- [Documentação](https://runapi.ai/pt-BR/docs/guides)
- [SDKs](https://runapi.ai/pt-BR/sdk.md)
- [CLI](https://runapi.ai/pt-BR/cli.md)
- [Servidor MCP](https://runapi.ai/pt-BR/mcp.md)
- [x402](https://runapi.ai/pt-BR/x402.md)
### Guias
- [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md)
- [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md)
### Empresa
- [Enterprise](https://runapi.ai/pt-BR/contact.md)
- [Contato](https://runapi.ai/pt-BR/contact.md)
### Legal
- [Termos](https://runapi.ai/pt-BR/terms.md)
- [Privacidade](https://runapi.ai/pt-BR/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/pt-BR",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/pt-BRicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "SoftwareApplication",
    "name": "RunAPI Luma para WorkBuddy",
    "applicationCategory": "DeveloperApplication",
    "description": "Modifique vídeos com Luma Ray 3.2 no WorkBuddy através do servidor MCP do RunAPI. Transformações guiadas por prompt com coerência espacial, uma API key.",
    "url": "https://runapi.ai/pt-BR/workbuddy-luma"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "Que tipo de transformações o Luma pode fazer no WorkBuddy?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "O Luma modify_video re-renderiza filmagens existentes com alterações guiadas por prompt — mudanças atmosféricas (névoa, chuva, hora dourada), transferências de estilo (cinematográfico, anime, noir), reformulações de iluminação e transformações ambientais. Preserva o movimento de câmera e o layout espacial originais, e o WorkBuddy conduz tudo a partir de um prompt em linguagem natural."
        }
      },
      {
        "@type": "Question",
        "name": "O que diferencia o Luma dos outros modelos de vídeo no RunAPI?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "O Luma é especializado em modificar vídeos existentes em vez de gerar do zero. Seu modelo Ray 3.2 mantém a coerência espacial 3D durante as transformações, então os objetos preservam suas relações de profundidade e o movimento de câmera permanece fisicamente consistente. Modelos como Kling ou Hailuo geram novos vídeos a partir de texto ou imagens — todos acessíveis pelo mesmo servidor MCP do runapi."
        }
      },
      {
        "@type": "Question",
        "name": "O WorkBuddy aguarda o resultado, ou eu faço o polling manualmente?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "O agente do workbench cuida disso. As tarefas do Luma são assíncronas — a ferramenta retorna um task_id e o WorkBuddy faz polling da tarefa pelo servidor MCP até que o status seja completed, depois publica a URL do vídeo modificado na sua conversa. O tempo de processamento típico é de 30 a 120 segundos."
        }
      },
      {
        "@type": "Question",
        "name": "Quanto custa a modificação de vídeo do Luma no RunAPI?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "O Luma usa cobrança fixa por tarefa — cada chamada modify_video tem um custo fixo independentemente da duração do vídeo. Consulte a página de preços do RunAPI para valores atuais. Gerações com falha não são cobradas."
        }
      },
      {
        "@type": "Question",
        "name": "Posso encadear o Luma com outros modelos de vídeo do RunAPI em uma sessão do WorkBuddy?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Sim. Peça ao WorkBuddy para gerar um vídeo com Kling ou Hailuo, depois passe a URL de saída como source_video_url para o Luma modify_video no pós-processamento — tudo pelo mesmo servidor MCP do runapi e RUNAPI_API_KEY, em uma única conversa."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "HowTo",
    "name": "Como usar Luma no WorkBuddy via RunAPI",
    "description": "Adicione o RunAPI como servidor MCP no WorkBuddy, entregue ao agente do workbench um vídeo de origem e um prompt de transformação, e receba o resultado re-renderizado do Luma Ray 3.2.",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "Adicione o servidor MCP do RunAPI",
        "text": "Registre o RunAPI como servidor MCP chamado runapi apontando para https://runapi.ai/mcp, com o cabeçalho Authorization lendo sua chave de RUNAPI_API_KEY. Se você já conectou o RunAPI ao WorkBuddy, o mesmo servidor expõe a ferramenta do Luma — nenhuma configuração extra necessária.",
        "url": "https://runapi.ai/pt-BR/workbuddy-luma#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "Instrua o agente da bancada de trabalho",
        "text": "Forneça ao WorkBuddy uma URL de vídeo de origem e descreva a transformação em linguagem natural — atmosfera, iluminação, estilo ou edições de cena. O agente mapeia sua solicitação para a ferramenta Luma modify_video com model definido como luma-modify-video, e o Luma preserva a geometria original da cena enquanto aplica as alterações.",
        "url": "https://runapi.ai/pt-BR/workbuddy-luma#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "Receba o vídeo modificado",
        "text": "A tarefa do Luma é assíncrona. O WorkBuddy faz polling pelo servidor MCP até que o status seja completed, depois publica a URL do vídeo re-renderizado na sua conversa. O tempo de processamento típico é de 30 a 120 segundos, dependendo da complexidade.",
        "url": "https://runapi.ai/pt-BR/workbuddy-luma#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "pt-BR",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "Início",
        "item": "https://runapi.ai/pt-BR"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "RunAPI Luma para WorkBuddy",
        "item": "https://runapi.ai/pt-BR/workbuddy-luma"
      }
    ]
  }
]
```
