A API de geração de vídeo com IA, a partir de texto ou imagens

Resumo rápido

A API de geração de vídeo do Mage é uma API REST em https://api.mage.space/v1 que executa 12 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.

• 12

  modelos de vídeo

• $0.02

  Padrão mais barato, por clipe

• 20

  Gerações simultâneas

• $0

  Mensalidade

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 é.

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.

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"

// 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);

# 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.

1. 01

   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.

2. 02

   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.

3. 03

   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

Casos de uso

O que os desenvolvedores criam com a API de vídeo

Perguntas frequentes

Perguntas frequentes

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Relacionados

• API de geração de imagens com IA
• API de geração de áudio com IA
• Servidor MCP do Mage
• SDKs do Mage
• Mage para ComfyUI
• Todos os modelos da API
• Playground da API
• Documentação da API