API do Mage · Modelo de vídeo

API do Raspberry

Personagens que ganham vida a partir de um primeiro quadro

Obter uma chave de APIExperimente o Raspberry no playground
POST https://api.mage.space/v1/raspberry/generate

Resumo rápido

A API do Raspberry executa o Raspberry pela Mage em POST https://api.mage.space/v1/raspberry/generate. Uma requisição com as configurações padrão custa 360 Gems (cerca de US$ 0,36), sem assinatura. O Raspberry usa characters salvos e referências por @handle no prompt.

Visão geral

O que a API do Raspberry faz

Vídeo de personagem a partir de um quadro inicial mais até 5 referências ou Characters, com Voices e áudio. De 2 a 15 segundos em 720p ou 1080p.

Um modelo de vídeo de personagem a partir de um primeiro quadro e imagens de referência, com Voices e áudio.

Aceita first_image, image, additional_images como entradas.

Início rápido

Chame a API do Raspberry

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modelos

Valores de model_id do Raspberry

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

model_idNomePadrão
raspberryRaspberrySim

Opções

Parâmetros do Raspberry

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, 4:3, 1:1, 3:4, 9:16
resolution720p, 1080p
duration2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Entradas

Entradas de mídia aceitas pelo Raspberry

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

CampoFunção
first_imageA imagem do primeiro frame.
imageA imagem de referência.
additional_imagesImagens de referência adicionais.

Mais modelos de vídeo

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

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

Vídeo · a partir de 618 Gems

API do Cherry

Nossa família de vídeos principal

Vídeo · a partir de 375 Gems

API do Grok Video

Grok Imagine em movimento

Vídeo · a partir de 270 Gems

API do Kiwi

Vídeo do dia a dia, sem configuração

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Raspberry?

Uma requisição do Raspberry com as configurações padrão (Raspberry) custa 360 Gems, cerca de US$ 0,36. 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 da Mage não é.

Qual é o endpoint da API do Raspberry?

POST https://api.mage.space/v1/raspberry/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 Raspberry posso chamar?

raspberry. O padrão é o Raspberry.

O Raspberry aceita imagens de referência ou characters?

O Raspberry aceita first_image, image, additional_images. O Raspberry usa characters salvos e referências por @handle no prompt.

Posso usar o Raspberry no Claude ou no ChatGPT?

Sim. Conecte o servidor MCP da Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Raspberry 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 Raspberry 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.

Obter uma chave de APIExperimente o Raspberry no playground

Relacionados