Saltar al contenido

API de Mage · Modelo de video

API de Seedance

Seedance, con filtro estricto

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

De un vistazo

La API de Seedance ejecuta Seedance 2.5 y otras 3 variantes a través de Mage en POST https://api.mage.space/v1/seedance/generate. Una solicitud con los ajustes predeterminados cuesta 618 Gems (unos 0,618 $), sin suscripción. Seedance acepta personajes guardados, referencias y referencias de audio mediante @handle en el prompt.

  • VideoResultado
  • 4Variantes
  • 618Gems por clip, predeterminado
  • $0.618Aprox., en USD

Resumen

Qué hace la API de Seedance

Seedance, de ByteDance, desde Seedance 2.0 Mini para borradores hasta Seedance 2.5, con clips de hasta 30 segundos, muchas referencias o Characters y ediciones a partir de un video de origen. Filtro estricto: se aplica el filtro de contenido del proveedor.

La línea de vídeo Seedance de ByteDance, con movimiento cinematográfico y audio: Seedance 2.0 Mini, Seedance 2.0 Fast, Seedance 2.0 y Seedance 2.5, el más potente, con clips de hasta 30 segundos. Filtro estricto: el filtro de contenido del proveedor revisa el prompt, el contenido de entrada y el vídeo terminado; si rechaza una solicitud, esta falla con `content_blocked` y un motivo, y se reembolsa.

Acepta image, additional_images y videos como entradas.

Inicio rápido

Llama a la API de Seedance

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modelos

Valores de model_id de Seedance

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

model_idNombrePredeterminado
seedance-2.0-miniSeedance 2.0 Mini
seedance-2.0-fastSeedance 2.0 Fast
seedance-2.0Seedance 2.0
seedance-2.5Seedance 2.5Sí

Opciones

Parámetros de Seedance

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

Archivos que acepta Seedance

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 Seedance

  • La edición de video requiere exactamente un video de origen, de 4 a 30 segundos en `seedance-2.5` y de 2 a 15 segundos en los demás modelos.
  • En `seedance-2.5`, una edición conserva la duración y la relación de aspecto del video de origen: `duration` y `aspect_ratio` se ignoran y el precio depende de la duración del video.

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 Seedance?
Una solicitud de Seedance con los ajustes predeterminados (Seedance 2.5) cuesta 618 Gems, unos 0,618 $. 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 Seedance?
POST https://api.mage.space/v1/seedance/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye un status_url que puedes consultar para obtener el resultado.
¿Qué modelos de Seedance puedo llamar?
seedance-2.0-mini (Seedance 2.0 Mini), seedance-2.0-fast (Seedance 2.0 Fast), seedance-2.0 (Seedance 2.0), seedance-2.5 (Seedance 2.5). El predeterminado es Seedance 2.5.
¿Seedance admite imágenes de referencia o personajes?
Seedance acepta image, additional_images y videos. Seedance acepta personajes guardados, referencias y referencias de audio mediante @handle en el prompt.
¿Puedo usar Seedance desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Seedance 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 Seedance?
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.