LumeClip

API e MCP do LumeClip para desenvolvedores

O LumeClip transforma um vídeo longo do YouTube em clipes curtos verticais (9:16) com legenda. Dá para usar por código, pela API REST, ou por um agente de IA, pelo servidor MCP hospedado. Os dois usam a mesma conta e o mesmo saldo de minutos.

Autenticação

Crie sua API key em Painel → Perfil → API Key (inclusive no plano grátis) e envie como Authorization: Bearer SUA_CHAVE para https://api.lumeclip.com. Guarde em segredo: ela tem acesso total à conta. Conectores MCP remotos, como o do claude.ai, entram com OAuth 2.1, sem chave para copiar.

Endpoints

Crie um projeto, consulte até o status ficar DONE e depois busque e baixe cada clipe. O processamento reserva minutos do saldo quando o projeto é criado. A descrição completa, legível por máquina, está na especificação OpenAPI.

POST /api/projects

Cria um projeto a partir de um vídeo público do YouTube

curl -X POST https://api.lumeclip.com/api/projects \
  -H "Authorization: Bearer $LUMECLIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sourceType":"YOUTUBE","sourceUrl":"https://www.youtube.com/watch?v=VIDEO_ID"}'

GET /api/projects/{projectId}

Status do projeto e os clipes dele

curl https://api.lumeclip.com/api/projects/PROJECT_ID \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

GET /api/clips/{clipId}

Um clipe, com o token da página pública de compartilhamento

curl https://api.lumeclip.com/api/clips/CLIP_ID \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

GET /api/clips/{clipId}/download

Baixa o clipe em MP4

curl -L -o clip.mp4 https://api.lumeclip.com/api/clips/CLIP_ID/download \
  -H "Authorization: Bearer $LUMECLIP_API_KEY"

Servidor MCP

O servidor MCP hospedado fica em https://api.lumeclip.com/mcp (Streamable HTTP). Ferramentas: create_project, get_project_status, list_clips e get_clip_url. No Claude Code, no Cursor ou no VS Code, envie a API key no cabeçalho Authorization. No claude.ai, adicione um conector personalizado com a mesma URL e entre na sua conta.

{
  "mcpServers": {
    "lumeclip": {
      "type": "http",
      "url": "https://api.lumeclip.com/mcp",
      "headers": { "Authorization": "Bearer lc_your_key" }
    }
  }
}

Escopos OAuth

lumeclip:read deixa o agente ver seus projetos e clipes. lumeclip:create deixa criar projetos, o que gasta minutos. offline_access mantém a conexão. Você escolhe na tela de consentimento e pode desconectar quando quiser em Perfil → Apps conectados. Token OAuth vale só no servidor MCP.

Limites

MCP: 120 chamadas por minuto por conta. REST: 100 requisições por minuto por IP e 20 projetos novos por hora. Toda resposta traz RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset; o 429 traz também Retry-After, em segundos. Erros vêm como JSON com error (mensagem) e, quando existe, code (estável, para o código decidir). Todo vídeo processado usa minutos do seu plano.

Versão e mudanças

Esta é a versão 1 da API. Campos e parâmetros opcionais novos podem entrar a qualquer momento. Mudança que quebra compatibilidade é avisada com pelo menos 30 dias de antecedência nesta página, e as operações afetadas passam a responder com os cabeçalhos Deprecation e Sunset nesse período.

Arquivos legíveis por máquina