Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Blueberry

Fixe o primeiro e o último frame

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

Resumo rápido

A API do Blueberry executa o Blueberry e mais 1 variante pelo Mage em POST https://api.mage.space/v1/blueberry/generate. Uma requisição com as configurações padrão custa 360 Gems (cerca de US$ 0,36), sem assinatura. O Blueberry aceita referências de áudio salvas, chamadas por @handle no prompt.

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

Visão geral

O que a API do Blueberry faz

Defina o primeiro e o último frame e veja o movimento ser preenchido entre eles, com áudio. De 2 a 15 segundos em 720p ou 1080p.

Um modelo de vídeo que preenche o movimento entre o primeiro e o último frame, com áudio; o Blueberry 2 é a versão atual.

Aceita first_image, last_image como entradas.

Início rápido

Chame a API do Blueberry

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modelos

Valores de model_id do Blueberry

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

model_idNomePadrão
blueberryBlueberry
blueberry-v2BlueberrySim

Opções

Parâmetros do Blueberry

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 Blueberry

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.

Regras

O que a API do Blueberry exige

  • O último frame só é compatível com `blueberry-v2`.

Mais modelos de vídeo

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

  • 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

  • Vídeo · a partir de 1.856 Gems

    API Magejutsu

    Refaça qualquer vídeo mantendo o movimento

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Blueberry?
Uma requisição do Blueberry com as configurações padrão (Blueberry) 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 do Mage não é.
Qual é o endpoint da API do Blueberry?
POST https://api.mage.space/v1/blueberry/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 Blueberry posso chamar?
blueberry, blueberry-v2. O padrão é o Blueberry.
O Blueberry aceita imagens de referência ou personagens?
O Blueberry aceita first_image e last_image. O Blueberry usa referências de áudio salvas por @handle no prompt.
Posso usar o Blueberry no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Blueberry 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 Blueberry ficam salvos?
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