API Seedance 1.0 Lite: Endpoint de Generación Rápida de Video

Una única solicitud POST, una espera de 30-60 segundos, y recibes un MP4 a 1080p. Esa es toda la API de Seedance 1.0 Lite. Para desarrolladores que construyen flujos de trabajo de video automatizados, ya sea animaciones de productos de comercio electrónico, tuberías de creatividad publicitaria o sistemas de generación de contenido, esta es la guía de integración.

RESUMEN

• Un único endpoint POST toma imagen + prompt de movimiento, devuelve un MP4 a 1080p
• Modelo de trabajo asincrónico: envía solicitud, consulta el estado, descarga el resultado
• Costo por llamada: $0.14-$0.84 según la duración (2-12 segundos)
• Latencia típica de extremo a extremo: 30-60 segundos
• 50 créditos gratuitos al registrarse, suficientes para validar la integración antes de comprometerse
• El mismo grupo de créditos funciona en todos los modelos de Arteza y Seedream

Por qué los desarrolladores integran la API

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

• Animación de catálogo automatizada: desencadena una generación para cada nuevo SKU agregado a tu backend de comercio electrónico
• Tuberías de creatividad publicitaria: genera variantes según un cronograma, empuja a plataformas publicitarias a través de sus APIs
• Sistemas de generación de contenido: alimenta imágenes del CMS en Arteza y obtén versiones animadas
• Flujos de trabajo generados por usuarios en tiempo real: permite que tus propios usuarios suban una imagen y obtengan una versión animada
• Trabajos por lotes: procesa cientos de imágenes de origen durante la noche

A $0.14-$0.84 por llamada y un turnaround de 30-60 segundos, puedes construir automatización de video de grado de producción que habría sido económicamente imposible hace 18 meses.

Obtener acceso a la API

1. Regístrate en la plataforma: 50 créditos gratuitos llegan inmediatamente
2. Navega a la configuración de API en tu panel de control
3. Genera una clave de API: guárdala de forma segura (nunca la confirmes en git)
4. Opcional: Compra un paquete de créditos en la página de precios: $10, $25, $50 o $100

Tus 50 créditos gratuitos también funcionan para llamadas de 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 requeridos

Parámetros opcionales

Modelo de respuesta

La API devuelve un ID de trabajo y estado. La generación es asincrónica: 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 se complete:

{
  "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 usan autenticación de token de portador a través del encabezado 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 a través del panel de control si sospechas una fuga.

Ejemplo de código: Python

Aquí hay una integración mínima de Python que envía un trabajo, consulta el estado de finalización 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"):
    # Submit the job
    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"]
    
    # Poll for completion
    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"Generation failed: {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"Video ready: {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') {
  // Submit the job
  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}` },
    }
  );

  // Poll for completion
  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('Video ready:', url));

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

El sondeo funciona, pero los webhooks son más limpios a escala. Pasa una webhook_url en tu solicitud de generación y la API publicará la carga de finalización cuando el trabajo se complete.

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 controlador de webhook recibe el mismo JSON de finalización que el endpoint de sondeo. No se requiere bucle de sondeo.

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

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

Límites de velocidad y concurrencia

Para mayor concurrencia o volumen, contacta al soporte. La plataforma puede soportar cargas de trabajo por lotes de 10,000+ trabajos/día en configuraciones dedicadas.

Manejo de errores

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

Para integraciones de producción, siempre implementa:

• Retroceso exponencial para errores 429 y 500
• Verificaciones de saldo de créditos antes de ejecuciones por lotes grandes
• Validación de firma de webhook si usas webhooks
• Claves de idempotencia para evitar cargos duplicados en errores de red

Gestión de costos en producción

Cada llamada carga créditos a la tarifa estándar: 7 créditos por segundo de video.

Consejos de control de costos en producción:

• Prueba prompts a 2 segundos antes de comprometerte con ejecuciones de lotes de 12 segundos
• Establece un presupuesto de créditos mensual y haz que tu código se detenga cuando se alcance
• Monitorea el campo credits_charged en cada respuesta para rastrear gastos por flujo de trabajo
• Usa webhooks para evitar quemar tiempo en sondeo
• Cachea resultados exitosos cuando sea posible para que solicitudes idénticas no se regeneren

Patrones de integración real

Animación de catálogo de comercio electrónico

Desencadena un trabajo de Seedance 1.0 Lite cada vez que se agrega un nuevo SKU a tu catálogo. Escribe la URL del MP4 resultante en tu base de datos de productos. Muestra en PDPs automáticamente.

Tubería de creatividad publicitaria

El trabajo cron diario genera 10 nuevas variantes de anuncios de diferentes imágenes de origen. Empuja MP4s directamente a la API de Meta Ads como nuevas creatividades. Cierra el ciclo entre generación de contenido y entrega de anuncios.

Aplicaciones de contenido generado por usuarios

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

Mejora del CMS

Enlaza tu CMS para que cualquier nueva imagen destacada obtenga una versión animada de Seedance 1.0 Lite generada automáticamente. Almacena ambas versiones: estática para respaldo, animada para ubicaciones de héroe.

Actualización de catálogo por lotes

El trabajo nocturno regenera versiones animadas de tus 500 productos principales con prompts de movimiento estacionales. Creatividad fresca sin intervención humana.

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

Cuando un trabajo específico necesita calidad premium, cambia endpoints:

• /seedance-1-lite/generate: $0.14-$0.84, rápido, volumen de trabajo caballo de batalla
• /seedance-1-pro/generate: $0.48-$2.88, movimiento premium, control de fotograma final
• /seedance-2.0/generate: $2.43-$9.10, calidad de cine + audio nativo

Misma clave de API, mismo grupo de créditos, misma autenticación. Cambia modelos llamando a un endpoint diferente. Ve la guía de comparación Pro para cuándo actualizar.

Comienza a integrar hoy

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

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