API do Mage · Modelo de vídeo
API do Plum
Som em todos os clipes, até 2K
POST https://api.mage.space/v1/plum/generateResumo 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_id | Nome | Padrão |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Sim |
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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 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.
| Campo | Função |
|---|---|
| first_image | A imagem do primeiro frame. |
| last_image | A imagem do último frame. |
| image | A imagem de referência. |
| additional_images | Imagens de referência adicionais. |
| videos | Os 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
API do Raspberry
Personagens ganham vida a partir de um primeiro frame
API do Seedance
Seedance, com filtro rigoroso
API do Wan 3.0
Wan 3.0, com filtro rigoroso
API do Wan Video v2.2
Vídeo com pesos abertos e uma variante Lightning
API do Berry
Vídeo fiel às suas referências
API do Blueberry
Fixe o primeiro e o último frame
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Plum?
Qual é o endpoint da API do Plum?
Quais modelos do Plum posso chamar?
O Plum aceita imagens de referência ou characters?
Posso usar o Plum no Claude ou no ChatGPT?
Por quanto tempo os resultados do Plum ficam guardados?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.