API de Mage · Modelo de video
API de Berry
Video fiel a tus referencias
POST https://api.mage.space/v1/berry/generateDe 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.
- VideoResultado
- 2Variantes
- 189Gems por clip, predeterminado
- $0.189Aprox., 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.
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 de Berry
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Sí |
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.
| 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
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.
| Campo | Rol |
|---|---|
| first_image | La imagen del primer fotograma. |
| image | La imagen de referencia. |
| additional_images | Imágenes de referencia adicionales. |
| video | El vídeo de origen. |
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
API de Blueberry
Fija el primer y el último fotograma
API de Cherry
Nuestra familia de vídeo insignia
API de Grok Video
Grok Imagine, en movimiento
API de Kiwi
Vídeo para el día a día, sin configuración
API de Lemon
Todas las funciones de vídeo, a un precio más amable
API de LTX Video
Vídeo rápido de pesos abiertos para iterar
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Berry?
¿Cuál es el endpoint de la API de Berry?
¿Qué modelos de Berry puedo usar?
¿Berry admite imágenes de referencia o personajes?
¿Puedo usar Berry desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Berry?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.