Para desenvolvedores

API de música e CLI

Transforme uma ideia ou sua letra em música pelos seus próprios scripts. Use a mesma conta, os mesmos créditos e a mesma biblioteca privada do app.

Conecte sua conta

Crie uma conta e verifique seu e-mail.
Abra as Configurações e crie uma chave de API. Chaves de API
Guarde a chave no servidor ou gerenciador de segredos. Envie no cabeçalho Authorization, nunca em uma URL ou no código do frontend.

As chaves expiram após 90 dias. Você pode ter cinco chaves ativas e revogar qualquer uma imediatamente nas Configurações. Chaves somente de leitura não geram músicas.

curl https://mcp.wordsintomusic.com/v1/account \
  -H "Authorization: Bearer $WIM_API_KEY"

Prepare, gere e acompanhe sua música

Primeiro prepare as instruções sem gastar créditos. Iniciar essa preparação usa um crédito de música existente. Mantenha o mesmo ID de solicitação ao tentar novamente. Um tempo limite não deve iniciar outra música.

{
  "requestId": "my-first-song-20261021",
  "input": {
    "mode": "idea",
    "idea": "Uma música esperançosa sobre recomeçar em uma nova cidade",
    "direction": "Pop acústico acolhedor, bateria constante, voz suave",
    "language": "pt-BR",
    "duration": 120
  },
  "uiLocale": "pt-BR"
}

Envie este JSON para POST /v1/songs/prepare. Depois envie o preparedRequestId recebido para POST /v1/songs/start. Consulte GET /v1/jobs/{jobId} com intervalos de pelo menos 15 segundos. Quando estiver pronta, abra o link privado da biblioteca para ouvir ou baixar.

Os idiomas disponíveis são inglês, espanhol, alemão, francês e português brasileiro. Solicite de 60 a 180 segundos. Use o modo lyrics para sua própria letra ou instrumental: true para música sem voz.

Endpoints da API

Método e caminho	Ação
`GET /v1/account`	Consultar seus créditos de música
`POST /v1/songs/prepare`	Preparar uma música sem gastar créditos
`POST /v1/songs/start`	Gerar a música preparada com um crédito existente
`GET /v1/jobs/{jobId}`	Consultar o status da geração
`GET /v1/songs`	Listar sua biblioteca privada de músicas
`GET /v1/songs/{id}`	Consultar uma das suas músicas

A URL base da API é https://mcp.wordsintomusic.com/v1. Baixar a especificação OpenAPI para consultar campos, limites, permissões e formatos de resposta.

Use a linha de comando

npm install -g words-into-music-cli
wim login --key-stdin
wim account
wim prepare --file brief.json
wim start PREPARED_REQUEST_ID --confirm
wim job JOB_ID
wim songs --limit 10

Use Node.js 22 ou superior. Passe a chave ao login pela entrada padrão ou forneça WIM_API_KEY pelo gerenciador de segredos. Não coloque a chave em argumentos ou no histórico do terminal. Execute wim --help para detalhes.

Créditos, limites e privacidade

O acesso à API e a CLI não exigem assinatura adicional. Gerar uma gravação usa sua cota existente, com os mesmos limites do app. A API nunca compra créditos nem inicia uma assinatura.

Somente as músicas do dono da chave podem ser consultadas. Letras são retornadas apenas quando solicitadas. Revogar uma chave bloqueia novas chamadas; uma música já aceita continua sendo processada.

O gateway permite até 30 solicitações de API por minuto por IP. Chamadas de API e MCP também compartilham um limite de 120 solicitações por conta por minuto. Respeite Retry-After nas respostas 429. IDs de preparações iniciadas permanecem disponíveis para evitar duplicações por 30 dias após expirarem.

Para conectar assistentes, use nosso Guia de configuração MCP. Para consultar as cotas da conta, veja Preços.

Conecte sua conta

Prepare, gere e acompanhe sua música

Endpoints da API

Use a linha de comando

Créditos, limites e privacidade

Tem uma música em mente? Torne-a sua.