API de Mage · Modelo de video
API de Cherry
Nuestra familia de video estrella
POST https://api.mage.space/v1/cherry/generateDe un vistazo
La API de Cherry ejecuta Cherry 2 Pro y otras 4 variantes a través de Mage en POST https://api.mage.space/v1/cherry/generate. Una solicitud con los ajustes por defecto cuesta 618 Gems (unos 0,618 $), sin suscripción. Cherry admite personajes guardados, referencias y referencias de audio mediante @handle en el prompt.
- VideoResultado
- 5Variantes
- 618Gems por clip, predeterminado
- $0.618Aprox., en USD
Resumen
Qué hace la API de Cherry
Video cinematográfico con audio, desde Cherry Mini para borradores hasta Cherry 2 Pro, nuestro modelo más potente, con clips de hasta 30 segundos, múltiples referencias o Characters y ediciones de video de origen.
La línea de vídeo estrella de Mage, con movimiento cinematográfico y audio: Cherry Mini, Cherry, Cherry Pro, Cherry 2 y Cherry 2 Pro, el más potente. Los modelos Cherry 2 crean clips de hasta 30 segundos.
Acepta image, additional_images y videos como entradas.
Inicio rápido
Llama a la API de Cherry
Define MAGE_API_KEY, envía la solicitud a /cherry/generate y consulta status_url hasta que se complete.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])Modelos
Valores de model_id de Cherry
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Sí |
Opciones
Parámetros de Cherry
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 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Entradas
Entradas multimedia que acepta Cherry
Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.
| Campo | Rol |
|---|---|
| image | La imagen de referencia. |
| additional_images | Imágenes de referencia adicionales. |
| videos | Los videos de origen. |
Reglas
Qué exige la API de Cherry
- La edición de vídeo admite exactamente un vídeo de origen, de 4 a 30 segundos en `cherry-2` y `cherry-2-pro`, y de 2 a 15 segundos en los demás modelos.
- En `cherry-2` y `cherry-2-pro`, una edición conserva la duración y la relación de aspecto del vídeo de origen: `duration` y `aspect_ratio` se ignoran, y el precio depende de la duración del vídeo.
Más modelos de vídeo
Otras API de generación de vídeo en Mage
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
API de Magejutsu
Cambia el reparto de cualquier video y conserva su movimiento
API de Melon
Anime en movimiento, con audio opcional
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Cherry?
¿Cuál es el endpoint de la API de Cherry?
¿Qué modelos de Cherry puedo llamar?
¿Cherry admite imágenes de referencia o personajes?
¿Puedo usar Cherry desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Cherry?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.