Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Plum

Som em todos os clipes, até 2K

POST https://api.mage.space/v1/plum/generate

Resumo rápido

A API do Plum executa o Plum Fast e outras 2 variantes pelo Mage em POST https://api.mage.space/v1/plum/generate. Uma requisição com as configurações padrão custa 173 Gems (cerca de US$ 0,173), sem assinatura. O Plum aceita personagens salvos, referências e referências de áudio por @handle no prompt.

  • VídeoSaída
  • 3Variantes
  • 173Gems por clipe, padrão
  • $0.173Aproximadamente, em USD

Visão geral

O que a API do Plum faz

Vídeo completo com áudio em todos os clipes e resolução de até 2K. Quadros inicial e final, até 9 referências ou Characters, e Voices; de 4 a 15 segundos.

O modelo de vídeo completo do Mage, com áudio gerado em todos os clipes e saída de até 2K, disponível como Plum, o mais rápido Plum Max e o Plum Fast, o mais veloz e de menor custo.

Aceita first_image, last_image, image, additional_images, videos como entrada.

Início rápido

Chame a API do Plum

Defina MAGE_API_KEY, envie para /plum/generate e consulte o status_url até a requisição ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "5",
  "model_id": "plum-fast"
}' | 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('plum', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'plum-fast',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("plum", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "plum-fast",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Plum

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
plumPlum
plum-maxPlum Max
plum-fastPlum FastSim

Opções

Parâmetros do Plum

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Entradas

Entradas de mídia aceitas pelo Plum

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
first_imageA imagem do primeiro frame.
last_imageA imagem do último frame.
imageA imagem de referência.
additional_imagesImagens de referência adicionais.
videosOs vídeos de origem.

Regras

O que a API do Plum exige

  • Primeiro e último quadro não podem ser combinados com imagens de referência: envie um tipo ou o outro.
  • No `plum-max` e no `plum-fast`, o último frame precisa ser combinado com um primeiro frame.
  • A edição de vídeo aceita exatamente um vídeo de origem de 2 a 15 segundos, uma `duration` de saída e até 2 imagens de referência, contando characters e referências mencionados. Não aceita quadros, referências de áudio nem vozes de characters: envie `use_character_voices: false` para mencionar um character que tenha voz.
  • No `plum-max`, o vídeo de origem é cobrado por segundo a uma taxa maior que a da saída, então em 768P uma edição custa mais no `plum-max` do que no `plum`.

Mais modelos de vídeo

Outras APIs de geração de vídeo no Mage

  • Vídeo · a partir de 360 Gems

    API do Raspberry

    Personagens ganham vida a partir de um primeiro frame

  • Vídeo · a partir de 618 Gems

    API do Seedance

    Seedance, com filtro rigoroso

  • Vídeo · a partir de 245 Gems

    API do Wan 3.0

    Wan 3.0, com filtro rigoroso

  • Vídeo · a partir de 40 Gems

    API do Wan Video v2.2

    Vídeo com pesos abertos e uma variante Lightning

  • Vídeo · a partir de 189 Gems

    API do Berry

    Vídeo fiel às suas referências

  • Vídeo · a partir de 360 Gems

    API do Blueberry

    Fixe o primeiro e o último frame

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Plum?
Uma requisição do Plum com as configurações padrão (Plum Fast) custa 173 Gems, cerca de US$ 0,173. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Plum?
POST https://api.mage.space/v1/plum/generate com um cabeçalho Authorization: Bearer contendo sua chave de API da Mage. A resposta inclui um status_url para você consultar o resultado.
Quais modelos do Plum posso chamar?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). O padrão é o Plum Fast.
O Plum aceita imagens de referência ou characters?
O Plum aceita first_image, last_image, image, additional_images, videos. O Plum usa characters salvos, referências e referências de áudio por @handle no prompt.
Posso usar o Plum no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP da Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Plum pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Plum ficam guardados?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

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

CharactersComunidade