API do Mage · Geração de vídeo
A API de geração de vídeo com IA, a partir de texto ou imagens
Texto para vídeo, imagem para vídeo, primeiro e último quadro e referência para vídeo com 15 modelos, liderados pelo Cherry 2 Pro, o principal modelo do Mage, com áudio em vários clipes.
POST https://api.mage.space/v1/{model}/generateResumo rápido
A API de geração de vídeo do Mage é uma API REST em https://api.mage.space/v1 que executa 15 modelos de texto para vídeo e imagem para vídeo, incluindo Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video e Wan. Envie um prompt e, se quiser, quadros ou referências, consulte o status da requisição e baixe um MP4. Cada clipe é pago em Gems de acordo com o modelo, a resolução e a duração.
- 15modelos de vídeo
- $0.02Padrão mais barato, por clipe
- 20Gerações simultâneas
- $0Mensalidade
Modelos
Todos os modelos de vídeo 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 |
|---|---|---|---|
| Berry | Vídeo fiel às suas referências | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fixe o primeiro e o último quadro | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Nossa família de vídeo principal | cherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, em movimento | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Vídeo do dia a dia, sem configuração | kiwi | 270 Gems ($0.27) |
| Lemon | Todos os recursos de vídeo, por um preço mais amigável | lemon | 245 Gems ($0.245) |
| LTX Video | Vídeo rápido de pesos abertos para iterar | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Magejutsu | Refaça qualquer vídeo mantendo o movimento | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| Melon | Anime em movimento, com áudio opcional | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Vídeo aberto e rápido com som estéreo | minimax-h3-turbo, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Som em todos os clipes, até 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Personagens ganham vida a partir de um primeiro quadro | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, com filtro rigoroso | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, com filtro rigoroso | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Vídeo de pesos abertos com uma variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Início rápido
Gere um vídeo com o Berry 2
Defina MAGE_API_KEY, envie a requisição e consulte o status até a conclusão. Troque berry na URL por qualquer modelo acima.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
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 vídeo
Vídeos curtos e para redes sociais
Produza clipes verticais para TikTok, Reels e Shorts a partir de um prompt ou de uma imagem de produto.
Anime imagens estáticas
Transforme um primeiro quadro, ou um primeiro e um último quadro, em movimento com modelos de imagem para vídeo como Lemon e Kiwi.
Histórias guiadas por personagens
Mantenha o mesmo personagem em várias cenas com modelos de referência para vídeo que aceitam personagens com @handle.
Vídeo com som
O Plum e outros modelos geram fala, efeitos sonoros e ambiência junto com a imagem, e aceitam referências de áudio para vozes.
Anúncios e demonstrações de produto
Gere várias variações de um comercial e escolha a vencedora, com envios idempotentes que nunca cobram em dobro.
Edite clipes existentes
Berry, Plum e Grok Video editam um vídeo de origem que você envia; Lemon e MiniMax-H3 também aceitam vídeos de referência.
Perguntas frequentes
Perguntas frequentes
Qual é a melhor API de geração de vídeo com IA?
A API de vídeo oferece suporte a imagem para vídeo?
Qual a duração máxima dos vídeos gerados?
Quanto tempo leva para gerar um vídeo?
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.