Saltar al contenido

API de Mage · Modelo de video

API de Cherry

Nuestra familia de video estrella

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

De 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_idNombrePredeterminado
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 ProSí

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.

CampoValores
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 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.

CampoRol
imageLa imagen de referencia.
additional_imagesImágenes de referencia adicionales.
videosLos 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

  • Vídeo · desde 375 Gems

    API de Grok Video

    Grok Imagine, en movimiento

  • Vídeo · desde 270 Gems

    API de Kiwi

    Vídeo para el día a día, sin configuración

  • Vídeo · desde 245 Gems

    API de Lemon

    Todas las funciones de vídeo, a un precio más amable

  • Vídeo · desde 20 Gems

    API de LTX Video

    Vídeo rápido de pesos abiertos para iterar

  • Vídeo · desde 1,856 Gems

    API de Magejutsu

    Cambia el reparto de cualquier video y conserva su movimiento

  • Vídeo · desde 147 Gems

    API de Melon

    Anime en movimiento, con audio opcional

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Cherry?
Una solicitud de Cherry con los ajustes por defecto (Cherry 2 Pro) cuesta 618 Gems, unos 0,618 US$. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la política de contenido de Mage la bloquea, no.
¿Cuál es el endpoint de la API de Cherry?
POST https://api.mage.space/v1/cherry/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye una status_url para consultar el resultado.
¿Qué modelos de Cherry puedo llamar?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2 (Cherry 2), cherry-2-pro (Cherry 2 Pro). El predeterminado es Cherry 2 Pro.
¿Cherry admite imágenes de referencia o personajes?
Cherry acepta image, additional_images y videos. Cherry usa personajes, referencias y referencias de audio guardados mediante @handle en el prompt.
¿Puedo usar Cherry desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Cherry por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Cherry?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

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

CharactersComunidad