ACE-Step
Disponível na APIace-step$0.0156/min de áudio
- Entrada → saída
- Prompt de textoÁudio
- Durações
- 10–240 s
ACE-Step
ACE Studio & StepFun
Entrada
promptEstilo, clima, instrumentos e andamento.instrumentalCom voz cantada, com a sua letra ou uma escrita para você.Sem custo extralyricsCantada como escrita; deixe vazio e uma letra é escrita para você.duration30 s30 s30 s
Preços da API do ACE-Step
Cada nível que vendemos, ao lado do preço oficial do fabricante do modelo.
| Nível | Opennan | Oficial |
|---|---|---|
| Por minuto de áudio | $0.0156 | Sem preço oficial |
O fabricante não vende este modelo exato na própria API (pesos abertos, ou descontinuado lá), então não há preço oficial para comparar.
Chame ACE-Step pelo seu código
Tudo para a sua primeira chamada está nesta página: o endpoint, uma chave, a requisição e cada parâmetro.
https:/Pegue uma chave de API
Crie uma chave no console. Ela usa o mesmo saldo do playground.
Criar uma chaveEnvie 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.
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.
https:/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 chaveSalve 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-..."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@opennanOu adicione só o servidor
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYOu adicione isto a ~/.codex/config.toml
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }Confira se opennan aparece na lista
codex mcp listReinicie 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 }
Perguntas sobre a API do ACE-Step
Quanto custa a API do ACE-Step?
API do ACE-Step na Opennan: $0.0156 por minuto de áudio. Os preços são em dólares americanos por chamada, mostrados antes de executar, e todos os níveis estão na tabela de preços.
Quais entradas o ACE-Step aceita?
Prompt de texto.
Quais opções uma chamada pode definir?
Faixas de 10 a 240 segundos.
Como é cobrado?
Por segundo de áudio gerado, com preço por minuto.
O que acontece se uma geração falhar?
Uma tarefa com falha é reembolsada integralmente. Você paga só pelos resultados.
Como chamo o ACE-Step de um agente de IA?
Adicione o servidor MCP https://api.opennan.com/v1/mcp com sua chave de API como token bearer e chame a ferramenta generate_music com model "ace-step". Ou envie um POST para https://api.opennan.com/v1/music/generations.
Modelos semelhantes
Modelos de Música que você pode chamar com a mesma chave.