API do Mage · Modelo de vídeo
API do Berry
Vídeo fiel às suas referências
POST https://api.mage.space/v1/berry/generateResumo 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_id | Nome | Padrão |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Sim |
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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 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.
| Campo | Função |
|---|---|
| first_image | A imagem do primeiro frame. |
| image | A imagem de referência. |
| additional_images | Imagens de referência adicionais. |
| video | O 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
API do Blueberry
Fixe o primeiro e o último frame
API do Cherry
Nossa família de vídeos principal
API do Grok Video
Grok Imagine em movimento
API do Kiwi
Vídeo do dia a dia, sem configuração
API do Lemon
Todos os recursos de vídeo, por um preço mais amigável
API do LTX Video
Vídeo open-weights rápido para iterar
Perguntas frequentes
Perguntas frequentes
Quanto custa a API do Berry?
Qual é o endpoint da API do Berry?
Quais modelos do Berry posso chamar?
O Berry aceita imagens de referência ou personagens?
Posso usar o Berry no Claude ou no ChatGPT?
Por quanto tempo os resultados do Berry ficam guardados?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.