# Música por IA

> Música por IA: Gere trilhas e clipes de música a partir de texto.

URL: https://apicultura.app/ferramentas/musica-ia/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Música por IA na APIcultura

Acesse Música por IA pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Gere trilhas e clipes de música a partir de texto. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Geração de mídia](/catalogo/?cat=midia). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `musica-clipe` | Clipe de música | R$ 0,36 | `POST /v1/call/musica-clipe` |
| `musica-faixa` | Faixa de música | R$ 0,72 | `POST /v1/call/musica-faixa` |

### Clipe de música (`musica-clipe`)

Gera um clipe curto de música. Preço: R$ 0,36 por chamada.

- `contents` (array, obrigatório), ex.: `[object Object]`

### Schema de entrada de musica-clipe

```json
{
  "required": [
    "contents"
  ],
  "properties": {
    "contents": {
      "type": "array"
    }
  }
}
```

### Faixa de música (`musica-faixa`)

Gera uma faixa de música a partir de um texto. Preço: R$ 0,72 por chamada.

- `contents` (array, obrigatório), ex.: `[object Object]`

### Schema de entrada de musica-faixa

```json
{
  "required": [
    "contents"
  ],
  "properties": {
    "contents": {
      "type": "array"
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "musica-clipe", "input": {"contents":[{"parts":[{"text":"An upbeat lo-fi hip hop instrumental with warm piano chords."}]}]}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/musica-clipe \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"An upbeat lo-fi hip hop instrumental with warm piano chords."}]}]}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 0,36 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Experimente

Teste no playground interativo: [Música por IA no playground](/ferramentas/ferramenta.html?slug=musica-ia). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Música por IA é marca de seus respectivos donos, citada apenas para identificar a integração.