API de geração de música

Ao vivo

Músicas de fundo e trilhas originais para os seus vídeos.

A partir de $0.0156 por minuto de áudio em 4 modelosMais baratoACE-Step

a partir de $0.0156/min

Entrada

PromptpromptEstilo, clima, instrumentos e andamento.

88 / 1.000

Experimente:

VocaisinstrumentalCom voz cantada, com a sua letra ou uma escrita para você.Sem custo extra

LetraopcionallyricsCantada como escrita; deixe vazio e uma letra é escrita para você.

147 / 4.000

Deixe em branco e a letra é escrita para você.

Duraçãoduration30 s

Qualquer duração de 10 a 240 segundos, cobrada por segundo.

30 s30 s

Exemplo

Resultado de exemploFeito com este prompt

uplifting acoustic folk, warm fingerpicked guitar, soft vocals, light percussion, 90 bpm

0:00 / 0:00

Compare modelos de API de geração de música

Todos os modelos deste endpoint, com preços ao vivo. Teste um no playground ou abra a página dele.

CassetteAI Sound EffectsCassetteAI$0.013 por faixa
Mais barato
Página
ACE-StepACE Studio & StepFun$0.0156 por minuto de áudio
Página
CassetteAI MusicCassetteAI$0.026 por minuto de áudio (cobrado por minuto iniciado)
Página
Stable Audio 3 Small SFXStability AI$0.02678 por faixa
Página
Stable Audio 3 SmallStability AI$0.02821 por faixa
Página
Stable Audio 3Stability AI$0.04888 por faixa
$0.08 por faixa-38%
Página

Todos os modelos desta ferramenta com o preço
		Oficial			Durações / tamanhos	Selos	Ações
CassetteAI Sound EffectsCassetteAI	$0.013 por faixa	Sem preço oficial	—	—	1–30 s	Mais barato	Página
ACE-StepACE Studio & StepFun	$0.0156 por minuto de áudio	Sem preço oficial	—	—	10–240 s		Página
CassetteAI MusicCassetteAI	$0.026 por minuto de áudio (cobrado por minuto iniciado)	Sem preço oficial	—	—	10–180 s		Página
Stable Audio 3 Small SFXStability AI	$0.02678 por faixa	Sem preço oficial	—	—	1–30 s		Página
Stable Audio 3 SmallStability AI	$0.02821 por faixa	Sem preço oficial	—	—	10–120 s		Página
Stable Audio 3Stability AI	$0.04888 por faixa	$0.08 por faixa	-38%	—	10–380 s		Página

Chame API de geração de música pelo seu código

Um endpoint para todos os modelos acima. Mude o campo model para trocar.

POSThttps://api.opennan.com/v1/music/generations

GET/v1/models?category=musicTodos os modelos deste endpoint, com preços

Pegue uma chave de API
Crie uma chave no console. Ela usa o mesmo saldo do playground.
Criar uma chave

Envie sua primeira requisição

A mesma requisição que o playground envia. Defina OPENNAN_KEY com sua chave.

curl https://api.opennan.com/v1/music/generations \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ace-step","prompt":"Lo-fi hip hop acolhedor, piano suave, chiado de vinil, andamento tranquilo","duration":30,"instrumental":true}'

# Then poll until "status" is "succeeded" or "failed":
curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"

Consulte a tarefa
A chamada responde na hora com um id de tarefa. Consulte a tarefa até ela terminar:
GEThttps://api.opennan.com/v1/tasks/{id}
queued
Esperando um worker
running
Em produção
succeeded
Pronto: outputs[].url traz os arquivos
failed
Falhou: nada é cobrado

Parâmetros

Gerados a partir do catálogo ao vivo: todo valor listado aqui é aceito pela API.

Parâmetros
Nome	Tipo	Valores aceitos	Padrão	Efeito no preço
`model`obrigatórioQual modelo executa a chamada.	texto	ace-step · stable-audio-3 · stable-audio-3-small · stable-audio-3-sfx · cassette-music · cassette-sfx	—	—
`prompt`obrigatórioEstilo, clima e instrumentos.	texto	—	—	—
`lyrics`opcionalLetra para cantar. Deixe de fora para música instrumental.	texto	—	—	—
`instrumental`opcionalMúsica sem vocais.	booleano	—	—	—
`duration`opcionalDuração da faixa em segundos.	inteiro	1–380	—	Cobrado por segundo de áudio
`callback_url`opcionalEnviamos a tarefa concluída para esta URL.	URL	—	—	—

Erros e como resolver

401Chave ausente ou errada
Envie o cabeçalho Authorization: Bearer com uma chave do console.
402Saldo insuficiente
Adicione crédito em Faturamento e envie a mesma chamada de novo.
400Um valor não é aceito
Leia error.message: ele indica o campo. Use um valor da tabela de parâmetros.
429Requisições demais
Aguarde alguns segundos e tente de novo, esperando mais após cada 429.

Adicione a Opennan ao seu app de IA

Uma instalação dá à sua IA todas as ferramentas da Opennan: vídeo, imagens, chat, voz, música, efeitos sonoros, 3D, legendas e dublagem. Escolha seu app e siga os passos.

Servidor MCPhttps://api.opennan.com/v1/mcp

Funciona no Codex CLI, no app do Codex e na extensão do Codex para IDE: todos usam ~/.codex/config.toml. Se o app ou a IDE não enxergar OPENNAN_KEY, use a opção config.toml com sua chave. O Codex pede aprovação antes de cada ferramenta: aprove para seguir.

Pegue uma chave de API
Crie uma chave no console. Ela começa com sk- e usa o mesmo saldo do site.
Criar uma chave

Salve sua chave como OPENNAN_KEY

# macOS / Linux (zsh shown; bash: ~/.bashrc)
echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc
source ~/.zshrc

# Windows (PowerShell), then open a new terminal
setx OPENNAN_KEY "sk-..."

3
Instale o plugin da Opennan: o servidor e uma skill que ensina sua IA a escolher modelos, confirmar preços e esperar os resultados
```
codex plugin marketplace add Opennan/opennan-ai-plugin
codex plugin add opennan@opennan
```

Ou adicione só o servidor

codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEY

Ou adicione isto a ~/.codex/config.toml

[mcp_servers.opennan]
url = "https://api.opennan.com/v1/mcp"
http_headers = { Authorization = "Bearer sk-..." }

4
Confira se opennan aparece na lista
```
codex mcp list
```
Reinicie o Codex e peça o que quiser
“Faça um vídeo de 5 segundos de chuva numa rua de neon, uma música para acompanhar e uma imagem de pôster.”

Troque sk-... pela sua chave e mantenha-a em segredo: quem tiver a chave pode gastar seu saldo. Seu app lista as ferramentas sem chave; para criar algo, você precisa de uma.

Use a partir de um agente de IA

Adicione o servidor MCP da Opennan ao seu agente e chame esta ferramenta.

Ferramenta: generate_music
Argumentos de exemplo: { "model": "ace-step", "prompt": "Lo-fi hip hop acolhedor, piano suave, chiado de vinil, andamento tranquilo", "duration": 30 }

API de geração de música: perguntas

Todos os modelos e preços

Quanto custa API de geração de música?

A partir de $0.0156 por minuto de áudio com ACE-Step, o mais barato de 4 modelos aqui. Você vê o preço antes de rodar.

Como chamo pelo meu código?

Envie POST https://api.opennan.com/v1/music/generations com sua chave de API. A resposta é um id de tarefa: consulte https://api.opennan.com/v1/tasks/{id} até a tarefa concluir ou falhar.

Posso trocar de modelo sem mudar meu código?

Sim. Mude o campo model e mantenha o resto da requisição, a mesma chave e o mesmo saldo.

Meu agente de IA pode usar?

Sim. Adicione o servidor MCP https://api.opennan.com/v1/mcp e chame a ferramenta generate_music, ou aponte seu agente para https://api.opennan.com/llms.txt.

O que acontece se uma execução falhar?

Uma execução com falha não é cobrada. Você paga só pelos resultados.