01
Apps de música e jogos
Deixa os utilizadores gerar faixas originais, musicar protótipos e criar música para cenas interativas sem saírem do teu produto.
API para programadores
API de geração de música com IA para programadores
Gera faixas instrumentais originais ou canções com voz a partir de uma descrição de estilo e das tuas letras. Começa com cURL ou TypeScript, ou liga o Cursor, o Claude Code e o Codex por MCP.
Disponível nos planos Pro e Ultra, com consumo por créditos.
Guia rápido em cURL
Terminal
curl https://www.lacuna.fm/api/v1/music/generations \
-H "Authorization: Bearer $LACUNA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"style": "lofi hip hop, mellow piano, 70 bpm",
"title": "Late Night Study",
"instrumental": true,
"model": "aether"
}'POST /api/v1/music/generationsCriar chave APIFeita para programadores e agentes
Uma API de geração de música que encaixa no teu fluxo de trabalho
De um pedido a uma faixa alojada, seja em código direto, com um SDK ou com o agente de programação que já usas.
Faixas completas a partir de um só pedido
- Descreve o estilo e o título que precisas
- Escolhe o modo instrumental ou envia as tuas próprias letras
- Recebe faixas completas com áudio alojado e metadados
Liga o Cursor, o Claude Code e o Codex
- Corre o servidor oficial lacuna-mcp diretamente a partir do npm
- Adiciona uma chave API à configuração MCP do teu agente de programação
- Pede música em linguagem natural e recebe uma faixa alojada
Usa REST, TypeScript, CLI ou MCP
- Chama a API REST a partir de qualquer linguagem de backend
- Usa os métodos tipados create, retrieve e waitFor no Node.js 18+
- Verifica assinaturas de webhook com o SDK oficial
Constrói sobre um ciclo assíncrono claro
- Cria uma tarefa e faz polling ou chama waitFor
- Recebe webhooks assinados job.completed e job.failed
- Tem devolução automática de créditos quando a geração falha
Escolhe a tua integração
Começa pela interface que encaixa na tua stack
A mesma Lacuna Music API está disponível por chamadas HTTP diretas, um SDK tipado, ferramentas de linha de comandos e um servidor MCP para o Cursor, o Claude Code, o Codex e outros agentes de programação.
API REST
Chama os endpoints HTTP a partir de qualquer linguagem e consulta cada pedido e resposta na referência OpenAPI.
Ver referência da APISDK TypeScript
Cria e consulta gerações com métodos tipados, polling com waitFor, erros estruturados e verificação de webhooks.
Ler o guia rápidoLinha de comandos
Gera e acompanha faixas a partir do terminal com a CLI do Lacuna Toolkit.
Ver configuração da CLIMCP para agentes de IA
Dá aos agentes de programação compatíveis acesso à geração de música através do servidor MCP da Lacuna.
Usar com agentes de IACasos de uso
Dois fluxos de trabalho, uma API de geração
Usa faixas completas dentro de produtos interativos ou automatiza a produção musical por trás dos teus fluxos de conteúdo e de agentes.
02
Fluxos de conteúdo e de agentes
Automatiza música original para vídeos, podcasts, materiais de campanha, playlists e tarefas iniciadas pelo teu agente de programação.
FAQ
Perguntas sobre a API de música com IA
Detalhes atuais de acesso, geração, faturação e integração.
A API cria faixas instrumentais completas ou canções com voz. Cada pedido inclui um título e uma descrição de estilo; as gerações com voz precisam também das letras fornecidas pela tua aplicação.
Não. Numa geração com voz, é a tua aplicação que fornece as letras. Usa as ferramentas de letras da Lacuna se precisares de as criar antes de enviar o pedido de música.
Não. Criar uma geração devolve uma tarefa assíncrona. Podes fazer polling ao estado, usar o helper waitFor do SDK TypeScript ou subscrever os webhooks assinados job.completed e job.failed.
Cria uma chave API no teu perfil Lacuna, guarda-a num gestor de segredos e envia-a como token Bearer. As chaves podem ser rodadas ou revogadas no mesmo painel.
Sim. Instala o servidor oficial lacuna-mcp, adiciona a tua chave API da Lacuna à configuração MCP do agente e pede faixas em linguagem natural. As mesmas ferramentas funcionam no Cursor, no Claude Code, no Codex e noutros clientes compatíveis com MCP.
A Music API está disponível nos planos Pro e Ultra. O consumo é por créditos e os detalhes atuais de cada plano estão na página de preços.
O endpoint de criação permite 60 pedidos por minuto por chave API. Os limites de geração em simultâneo são, por omissão, 10 tarefas no Pro e 20 no Ultra; podem existir valores específicos por conta.
Os créditos são descontados quando a tarefa é criada e devolvidos automaticamente se a geração falhar. Os erros tipados e os eventos de webhook permitem que a tua aplicação trate a falha de forma explícita.
As músicas geradas durante uma subscrição Pro ou Ultra ativa estão abrangidas pela licença comercial da Lacuna, e esses direitos comerciais mantêm-se depois de a subscrição terminar.
Constrói com a Lacuna
Faz o teu primeiro pedido à API de música com IA
Cria uma chave API, copia um comando cURL pronto a correr ou liga o Cursor, o Claude Code e o Codex através do servidor MCP da Lacuna.