Saltar al contenido

API de Mage · Modelo de video

API de Melon

Anime en movimiento, con audio opcional

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

De un vistazo

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

  • VideoResultado
  • 2Variantes
  • 147Gems por clip, predeterminado
  • $0.147Aprox., en USD

Resumen

Qué hace la API de Melon

Nuestro modelo de vídeo anime, disponible como Melon y Melon Pro. Fotogramas inicial y final, o hasta 7 referencias o Characters, audio opcional, de 3 a 16 segundos y hasta 1080p.

El modelo de video de anime de Mage, disponible como Melon y Melon Pro, con audio opcional.

Acepta first_image, last_image, image y additional_images como entradas.

Inicio rápido

Llama a la API de Melon

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/melon/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": "melon"
}' | 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('melon', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'melon',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("melon", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "melon",
})

print(request["result"]["url"])

Modelos

Valores de model_id de Melon

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

model_idNombrePredeterminado
melonMelonSí
melon-proMelon Pro

Opciones

Parámetros de Melon

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, 3:4, 4:3
resolution540p, 720p, 1080p
duration3, 4, 5, 6, 8, 10, 16

Entradas

Entradas multimedia que acepta Melon

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

CampoRol
first_imageLa imagen del primer fotograma.
last_imageLa imagen del último fotograma.
imageLa imagen de referencia.
additional_imagesImágenes de referencia adicionales.

Reglas

Qué reglas aplica la API de Melon

  • Los fotogramas inicial y final no se pueden combinar con imágenes de referencia: envía un tipo o el otro.
  • El prompt puede tener un máximo de 5000 caracteres.

Más modelos de vídeo

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

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Melon?
Una solicitud de Melon con los ajustes por defecto (Melon) cuesta 147 Gems, unos $0.147. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de Melon?
POST https://api.mage.space/v1/melon/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye una status_url que puedes consultar para obtener el resultado.
¿Qué modelos de Melon puedo usar?
melon (Melon), melon-pro (Melon Pro). El modelo predeterminado es Melon.
¿Melon admite imágenes de referencia o personajes?
Melon acepta first_image, last_image, image y additional_images. Melon admite personajes guardados y referencias mediante @handle en el prompt.
¿Puedo usar Melon desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Melon por su nombre. Tu asistente lee sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Melon?
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