API de Berry

De un vistazo

La API de Berry ejecuta Berry 2 y otra variante a través de Mage en POST https://api.mage.space/v1/berry/generate. Una solicitud con los ajustes predeterminados cuesta 189 Gems (unos 0,189 $), sin suscripción. Berry admite personajes y referencias guardados mediante @handle en el prompt.

• Video

  Resultado

• 2

  Variantes

• 189

  Gems por clip, predeterminado

• $0.189

  Aprox., en USD

Resumen

Qué hace la API de Berry

Video que se mantiene fiel a cada referencia que le des. Un fotograma inicial, hasta 9 referencias o Characters, o un video de origen para editar; de 3 a 15 segundos en hasta 1080p.

El modelo de video basado en referencias de Mage, fiel a las imágenes que le das; Berry 2 es la versión actual. Un primer fotograma o imágenes de referencia, o un video de origen para editar.

Acepta como entradas first_image, image, additional_images y video.

Inicio rápido

Llama a la API de Berry

Define MAGE_API_KEY, envía la solicitud a /berry/generate y consulta status_url hasta que se complete.

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"

// 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);

# 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 de Berry

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

Opciones

Parámetros de Berry

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

Entradas

Archivos de entrada que acepta Berry

Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.

Reglas

Lo que impone la API de Berry

• Un primer fotograma no se puede combinar con imágenes de referencia.
• La edición de vídeo solo funciona con `berry`, no con `berry-2`: envía `model_id: "berry"` con un vídeo de origen de entre 3 y 60 segundos.

Más modelos de vídeo

Otras API de generación de vídeo en Mage

Preguntas frecuentes

Preguntas frecuentes

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

Relacionado

• API de generación de video con IA
• Referencia de la API de Berry
• Playground de Berry
• Todos los modelos de la API
• Servidor MCP de Mage