API de Seedance 1.0 Lite: endpoint de generación de video rápida

Una sola solicitud POST, una espera de 30-60 segundos y obtienes un MP4 en 1080p. Eso es todo el API de Seedance 1.0 Lite. Para desarrolladores que construyen flujos de trabajo de vídeo automatizados, ya sea animaciones de productos para e-commerce, pipelines de creatividades publicitarias o sistemas de generación de contenido, esta es la guía de integración.

Resumen rápido

• Un único endpoint POST recibe imagen + prompt de movimiento y devuelve un MP4 en 1080p
• Modelo de trabajo asíncrono: envía la solicitud, consulta el estado y descarga el resultado
• Coste por llamada: $0,20-$1,00 según la duración (2-12 segundos)
• Latencia típica de extremo a extremo: 30-60 segundos
• 10 créditos gratis al registrarte, suficientes para validar la integración antes de comprometerte
• El mismo pool de créditos funciona con todos los modelos de Arteza y Seedream

Por qué los desarrolladores integran el API

La versión de interfaz de Seedance 1.0 Lite es ideal para la generación manual. El API desbloquea los flujos de trabajo que el uso manual no puede soportar:

• Animación automatizada de catálogo - activa una generación por cada nuevo SKU añadido a tu backend de e-commerce
• Pipelines de creatividades publicitarias - genera variantes de forma programada y envíalas a plataformas publicitarias a través de sus APIs
• Sistemas de generación de contenido - alimenta Arteza con imágenes del CMS y obtén versiones animadas
• Flujos de trabajo generados por el usuario en tiempo real - permite que tus propios usuarios suban una imagen y reciban una versión animada
• Trabajos en lote - procesa cientos de imágenes de origen durante la noche

A $0,20-$1,00 por llamada y con un tiempo de respuesta de 30-60 segundos, puedes construir automatización de vídeo a nivel de producción que habría sido económicamente imposible hace 18 meses.

Cómo obtener acceso al API

1. Regístrate en la plataforma - 10 créditos gratis llegan de inmediato
2. Ve a la configuración del API en tu panel de control
3. Genera una clave de API - guárdala de forma segura (nunca la incluyas en git)
4. Opcional: Elige un plan mensual en la página de precios - $5, $25, $50 o $120

Tus 10 créditos gratuitos también funcionan para llamadas al API. Puedes validar la integración completa antes de pagar nada.

El modelo de solicitud

La interacción principal es un único POST al endpoint de generación de Seedance 1.0 Lite.

Parámetros obligatorios

Parámetros opcionales

Modelo de respuesta

El API devuelve un ID de trabajo y un estado. La generación es asíncrona: consulta el estado de finalización o usa un webhook.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Cuando finaliza:

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

Autenticación

Todas las solicitudes utilizan autenticación por token de portador a través de la cabecera Authorization:

Authorization: Bearer YOUR_API_KEY

Las claves de API están vinculadas a tu cuenta y se cargan contra tu saldo de créditos. Rota las claves desde el panel de control si sospechas que hubo una filtración.

Ejemplo de código: Python

Aquí tienes una integración mínima en Python que envía un trabajo, consulta su estado hasta que finaliza y descarga el resultado.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # Enviar el trabajo
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # Consultar hasta que finalice
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"La generación falló: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Vídeo listo: {video_url}")

Ejemplo de código: Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // Enviar el trabajo
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // Consultar hasta que finalice
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Vídeo listo:', url));

Patrón de webhook (recomendado para producción)

El sondeo funciona, pero los webhooks son más limpios a escala. Incluye un webhook_url en tu solicitud de generación y el API hará un POST con el payload de finalización cuando el trabajo concluya.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

Tu manejador de webhook recibe el mismo JSON de finalización que el endpoint de sondeo. No se necesita ningún bucle de consulta.

¿Quieres hacerlo tú mismo? Prueba Seedance 1.0 Lite gratis →

¿Listo para probar Seedance 1.0 Lite? Empieza a crear gratis →

Límites de velocidad y concurrencia

Para mayor concurrencia o volumen, contacta con el soporte. La plataforma puede soportar cargas de trabajo en lote de más de 10.000 trabajos al día en configuraciones dedicadas.

Gestión de errores

Se aplican los códigos de estado HTTP estándar:

Para integraciones en producción, implementa siempre:

• Retroceso exponencial para errores 429 y 500
• Comprobaciones del saldo de créditos antes de grandes ejecuciones en lote
• Validación de firma del webhook si utilizas webhooks
• Claves de idempotencia para evitar cargos duplicados en errores de red

Gestión de costes en producción

Cada llamada carga créditos según la duración: 2 créditos para un clip de 2-3 segundos, llegando a 7 créditos en 12 segundos.

Consejos para controlar costes en producción:

• Prueba los prompts a 2 segundos antes de comprometerte con ejecuciones en lote de 12 segundos
• Establece un presupuesto mensual de créditos y haz que tu código se detenga cuando se alcance
• Monitoriza el campo credits_charged en cada respuesta para rastrear el gasto por flujo de trabajo
• Usa webhooks para evitar desperdiciar tiempo en sondeos
• Almacena en caché los resultados exitosos cuando sea posible para que solicitudes idénticas no regeneren el contenido

Patrones de integración reales

Animación de catálogo para e-commerce

Activa un trabajo de Seedance 1.0 Lite cada vez que se añada un nuevo SKU a tu catálogo. Escribe la URL del MP4 resultante en tu base de datos de productos. Muéstralo en las páginas de detalle de producto de forma automática.

Pipeline de creatividades publicitarias

Un cron job diario genera 10 nuevas variantes de anuncios a partir de diferentes imágenes de origen. Envía los MP4 directamente a la API de Meta Ads como nuevas creatividades. Cierra el ciclo entre la generación de contenido y la entrega publicitaria.

Aplicaciones de contenido generado por el usuario

Permite que los usuarios suban una foto en tu aplicación. Tu backend llama a Seedance 1.0 Lite con un prompt predefinido. Devuelve la versión animada al usuario en menos de un minuto. Cobra a los usuarios lo suficiente para cubrir el coste del API de ~$0.20 con un margen saludable.

Mejora del CMS

Conecta tu CMS de forma que cualquier nueva imagen destacada genere automáticamente una versión animada con Seedance 1.0 Lite. Almacena ambas versiones: la estática como alternativa y la animada para posiciones destacadas.

Actualización masiva del catálogo

Un trabajo nocturno regenera versiones animadas de tus 500 productos principales con prompts de movimiento estacionales. Creatividades frescas sin intervención humana.

Actualización a Pro o 2.0 a través del API

Cuando un trabajo específico necesite calidad premium, cambia de endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, rápido, el caballo de batalla para volumen
• /seedance-1-pro/generate - $0,20-$1,00, movimiento premium, control del fotograma final
• /seedance-2.0/generate - $1.20-$4.40, calidad cinematográfica y audio nativo

La misma clave de API, el mismo pool de créditos y la misma autenticación. Cambia de modelo llamando a un endpoint diferente. Consulta la guía de comparación Pro para saber cuándo conviene actualizar.

Empieza a integrar hoy mismo

Regístrate, obtén tu clave de API desde el panel de control y realiza tu primera llamada con los 10 créditos gratuitos. El ejemplo de Python anterior se ejecuta de extremo a extremo en unos 45 segundos y te proporciona un patrón de integración funcional sobre el que construir.

Obtén tu clave de API gratis → - 10 créditos al registrarte, sin tarjeta requerida, integración lista para producción en menos de una hora.