API do Mage · Geração de áudio
A API de geração de áudio com IA para vozes, música e sons
Fala, narração, música e efeitos sonoros a partir de um único prompt com o Seed Audio, com referências de voz e controles de fala, volume e tom.
POST https://api.mage.space/v1/{model}/generateResumo rápido
A API de geração de áudio do Mage roda o Seed Audio em https://api.mage.space/v1/seed_audio/generate. Envie um prompt de texto, com referências de voz ou uma imagem se quiser, e receba um arquivo de áudio de até 120 segundos com vozes, música ou efeitos sonoros. Cada clipe é pago em Gems, sem assinatura.
- 4modelos de áudio
- $0.019Padrão mais barato, por clipe
- 20Gerações simultâneas
- $0Mensalidade
Modelos
Todos os modelos de áudio da API do Mage
Os preços são por geração, em Gems. 1.000 Gems custam US$ 1 no pacote padrão, e pacotes maiores dão Gems de bônus. O preço depende do modelo, da resolução e da duração; é mostrado o preço com as configurações padrão, e cada resposta informa o valor exato cobrado em billing.gems_charged. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
| Modelo | Ideal para | Valores de model_id | Preço padrão |
|---|---|---|---|
| Eleven Music | Músicas da ElevenLabs, com ou sem vocais | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: fala realista que você pode dirigir | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Músicas completas a partir da sua letra, com pesos abertos | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Vozes, música e efeitos sonoros a partir de um único prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Início rápido
Gere áudio com o Eleven Music v2.5
Defina MAGE_API_KEY, envie a solicitação e consulte até ela ser concluída. Troque eleven_music na URL por qualquer modelo acima.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
print(request["result"]["url"])Como funciona
Da chave de API à mídia pronta em três chamadas
Todos os modelos compartilham um único esquema de autenticação, um único ciclo de requisição assíncrona e os mesmos nomes de campos.
Crie uma chave de API
Entre no Mage, abra API → Chaves de API e crie uma chave. Ela começa com mage_sk_ e é exibida uma única vez. Uma conta pode ter até 10 chaves ativas.
Envie uma geração
Faça um POST com um corpo JSON para https://api.mage.space/v1/{model}/generate com um cabeçalho Authorization: Bearer. A resposta volta na hora com um request_id, um status e uma status_url. Envie um cabeçalho Idempotency-Key para que uma nova tentativa nunca cobre duas vezes.
Consulte e baixe
Consulte a status_url até o status ser completed, failed ou cancelled. Uma requisição concluída traz result.url com o arquivo de imagem, vídeo ou áudio, mantido por 30 dias.
Feito para produção
O que cada requisição da API do Mage inclui
Uma chave, todos os modelos
37 modelos de imagem, vídeo e áudio em uma única API REST e um único saldo de Gems. Troque de modelo mudando o caminho da URL.
Pague por geração
Sem assinatura e sem gasto mínimo. Você compra Gems e cada requisição é cobrada pelo preço listado. Uma geração que falha é reembolsada, a menos que tenha sido bloqueada pela política de conteúdo do Mage.
Novas tentativas seguras
As chaves de idempotência fazem com que o reenvio de uma requisição retorne a requisição original, sem cobrar de novo.
Personagens consistentes
Salve um personagem ou uma referência uma vez e escreva @handle em qualquer prompt para usá-lo com todos os modelos compatíveis.
Entradas grandes
Envie entradas de imagem, vídeo e áudio como URLs ou data URLs, ou faça upload de arquivos de até 100 MB por meio de um upload assinado.
20 gerações simultâneas
Cada conta pode executar 20 gerações ao mesmo tempo, e o limite pode ser ampliado para o seu caso de uso. Requisições recusadas nunca são cobradas.
Casos de uso
O que os desenvolvedores criam com a API de áudio
Narração e locução
Gere narração para vídeos, explicativos e audiolivros, com controles de velocidade da fala, volume e tom.
Vozes consistentes
Salve um clipe de voz como referência e mencione-o pelo @handle para manter a mesma voz em vários clipes.
Efeitos sonoros
Crie sons ambientes, foley e sons de interface a partir de uma descrição, para jogos e apps.
Trilhas de fundo
Produza música de fundo para clipes de redes sociais e anúncios a partir de um prompt.
Trilhas sonoras para vídeos gerados
Combine o Seed Audio com a API de vídeo para adicionar som a clipes de modelos sem áudio.
Agentes que falam
Deixe o Claude, o ChatGPT ou seu próprio agente produzir áudio pelo servidor MCP ou pela API REST.
Perguntas frequentes
Perguntas frequentes
A API de áudio faz conversão de texto em fala?
Qual é a duração máxima do áudio gerado?
Quanto custa a API do Mage?
Preciso ser membro do Mage para usar a API?
Posso usar os resultados da API para fins comerciais?
Quais são os limites de uso?
Meu agente de IA pode usar a API do Mage?
Existe um SDK para a API do Mage?
Já uso outra API de geração. O que preciso mudar?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.