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.
Vídeo
Saída
1
Variante
360
Gems por clipe, padrão
$0.36
Aproximadamente, em USD
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_id | Nome | Padrão |
|---|---|---|
| raspberry | Raspberry | Sim |
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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 720p, 1080p |
| duration | 2, 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.
| Campo | Função |
|---|---|
| first_image | A imagem do primeiro frame. |
| image | A imagem de referência. |
| additional_images | Imagens 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.