API de Mage · Modelo de video

API de Kiwi

Video cotidiano, sin configuración

Obtén una clave de APIPrueba Kiwi en el playground
POST https://api.mage.space/v1/kiwi/generate

De un vistazo

La API de Kiwi ejecuta Kiwi a través de Mage en POST https://api.mage.space/v1/kiwi/generate. Una solicitud con los ajustes por defecto cuesta 270 Gems (unos 0,27 $), sin suscripción. Kiwi no admite menciones con @handle.

Resumen

Qué hace la API de Kiwi

Video sencillo y fiable a partir de texto o de un fotograma inicial, sin nada más que configurar. De 5 o 10 segundos y hasta 1080p.

Video cotidiano a partir de texto o de un único fotograma inicial, sin nada más que configurar.

Acepta first_image como entrada.

Inicio rápido

Llama a la API de Kiwi

Define MAGE_API_KEY, envía la solicitud a /kiwi/generate y consulta status_url hasta que termine.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modelos

Valores de model_id de Kiwi

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

model_idNombrePredeterminado
kiwiKiwiSí

Opciones

Parámetros de Kiwi

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

CampoValores
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration5, 10

Entradas

Entradas multimedia que acepta Kiwi

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.

Más modelos de vídeo

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

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 147 Gems

API de Melon

Anime en movimiento, con audio opcional

Video · desde 30 Gems

API de MiniMax-H3

Video abierto y rápido con sonido estéreo

Vídeo · desde 338 Gems

API de Plum

Sonido en cada clip, hasta 2K

Vídeo · desde 360 Gems

API de Raspberry

Personajes que cobran vida desde un primer fotograma

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Kiwi?

Una solicitud de Kiwi con los ajustes por defecto (Kiwi) cuesta 270 Gems, unos 0,27 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se te reembolsa; si la política de contenido de Mage la bloquea, no.

¿Cuál es el endpoint de la API de Kiwi?

POST https://api.mage.space/v1/kiwi/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 Kiwi puedo llamar?

kiwi. El predeterminado es Kiwi.

¿Kiwi admite imágenes de referencia o personajes?

Kiwi acepta first_image. Kiwi no admite menciones con @handle.

¿Puedo usar Kiwi desde Claude o ChatGPT?

Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Kiwi 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 Kiwi?

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.

Obtén una clave de APIPrueba Kiwi en el playground

Relacionado