Uma chave, todos os modelos
28 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.
Resumo 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.
1
modelos de áudio
$0.019
Padrão mais barato, por clipe
20
Gerações simultâneas
$0
Mensalidade
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 |
|---|---|---|---|
| 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 Seed Audio
Defina MAGE_API_KEY, envie a requisição e consulte o status até a conclusão. Troque seed_audio na URL por qualquer modelo acima.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
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
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?
Sim. O Seed Audio lê um roteiro com uma voz descrita ou com uma referência de voz salva, e oferece ajustes de velocidade da fala, volume e tom. Ele também gera música e efeitos sonoros a partir do mesmo campo de prompt.
Qual é a duração máxima do áudio gerado?
O Seed Audio gera clipes de até 120 segundos.
Quanto custa a API do Mage?
Não há assinatura nem mensalidade. Cada geração é paga em Gems, pelo preço listado do modelo, e 1.000 Gems custam US$ 1 no pacote padrão. A página de cada modelo mostra o preço com as configurações padrão, e cada resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage, não. Uma requisição que o seu saldo não cobre é recusada antes de qualquer cobrança.
Preciso ser membro do Mage para usar a API?
Não. A API funciona apenas com Gems. Os planos de assinatura e a geração ilimitada no app não valem para requisições de API, então qualquer conta do Mage com Gems pode usá-la.
Posso usar os resultados da API para fins comerciais?
Sim. O conteúdo que você cria com o Mage, inclusive pela API e pelo servidor MCP, pode ser usado comercialmente. Os créditos são bem-vindos, mas não obrigatórios.
Quais são os limites de uso?
Uma conta pode ter até 20 gerações na fila ou em andamento ao mesmo tempo. Um envio além disso é recusado com o erro 429 e não custa nada. Escreva para [email protected] para aumentar o limite para o seu caso de uso.
Meu agente de IA pode usar a API do Mage?
Sim. Agentes podem chamar a API REST com uma chave ou se conectar ao servidor MCP do Mage, que oferece ao Claude, ChatGPT, Claude Code, Grok e Cursor dezesseis ferramentas prontas para escolher um modelo, consultar o preço, gerar e buscar o resultado. Veja o servidor MCP.
Existe um SDK para a API do Mage?
Sim. O pacote oficial @mage-space/sdk no npm e o mage-space no PyPI são de código aberto e tipados para todos os modelos. Eles enviam a solicitação, aguardam o resultado, repetem com segurança e fazem upload de arquivos para você. Quem usa ComfyUI pode instalar o pacote de nós comfyui-mage. Veja os SDKs do Mage.
Já uso outra API de geração. O que preciso mudar?
Aponte seu cliente para https://api.mage.space/v1, envie sua chave do Mage como token Bearer e mapeie seus campos para a página do modelo: prompt, aspect_ratio, resolution, duration e model_id funcionam da mesma forma em todos os modelos do Mage. As solicitações são assíncronas: envie e depois consulte status_url periodicamente.
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.