Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Berry

Vídeo fiel às suas referências

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

Resumo rápido

A API do Berry executa o Berry 2 e mais 1 variante pelo Mage em POST https://api.mage.space/v1/berry/generate. Uma requisição com as configurações padrão custa 189 Gems (cerca de US$ 0,189), sem assinatura. O Berry aceita personagens salvos e referências por @handle no prompt.

  • VídeoSaída
  • 2Variantes
  • 189Gems por clipe, padrão
  • $0.189Aproximadamente, em USD

Visão geral

O que a API do Berry faz

Vídeo que se mantém fiel a cada referência que você envia. Um frame inicial, até 9 referências ou Characters, ou um vídeo de origem para editar; de 3 a 15 segundos em até 1080p.

O modelo de vídeo do Mage guiado por referências, fiel às imagens que você envia; o Berry 2 é a versão atual. Um primeiro frame ou imagens de referência, ou um vídeo de origem para editar.

Aceita first_image, image, additional_images e video como entradas.

Início rápido

Chame a API do Berry

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

cURL
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"
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('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);
Python
# 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"])

Modelos

Valores de model_id do Berry

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

model_idNomePadrão
berryBerry
berry-2Berry 2Sim

Opções

Parâmetros do Berry

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

Entradas

Entradas de mídia aceitas pelo Berry

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.
videoO vídeo de origem.

Regras

O que a API do Berry exige

  • Não é possível combinar um primeiro frame com imagens de referência.
  • A edição de vídeo funciona apenas no `berry`, não no `berry-2`: envie `model_id: "berry"` com um vídeo de origem de 3 a 60 segundos.

Mais modelos de vídeo

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

  • 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

  • Vídeo · a partir de 245 Gems

    API do Lemon

    Todos os recursos de vídeo, por um preço mais amigável

  • Vídeo · a partir de 20 Gems

    API do LTX Video

    Vídeo open-weights rápido para iterar

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Berry?
Uma requisição do Berry com as configurações padrão (Berry 2) custa 189 Gems, cerca de US$ 0,189. 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 Berry?
POST https://api.mage.space/v1/berry/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Berry posso chamar?
berry (Berry), berry-2 (Berry 2). O padrão é o Berry 2.
O Berry aceita imagens de referência ou personagens?
O Berry aceita first_image, image, additional_images, video. O Berry também usa personagens e referências salvos, chamados por @handle no prompt.
Posso usar o Berry no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Berry 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 Berry 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