Seedance 2.0 Fast API: endpoint de generación de video económico

Una solicitud HTTP, un clip de vídeo de calidad cinematográfica con IA, $1,94. Esa es la economía unitaria de construir sobre la API de Seedance 2.0 Fast. Endpoints dedicados para texto a vídeo e imagen a vídeo, precios deterministas, el mismo motor de calidad que Seedance 2.0 estándar y una ventaja de coste de aproximadamente un 20% que importa cuando operas a escala.

Aquí tienes la guía completa para desarrolladores.

Resumen rápido

• Endpoints: bytedance/seedance-2.0/fast/text-to-video y fast/image-to-video
• Coste: $0,2419 por segundo, o 10-55 créditos por clip ($1,00-$5,50)
• Respuesta: ID de trabajo asíncrono, consulta de estado y descarga en MP4
• Autenticación: Clave API desde tu Panel de Arteza
• Velocidad: 30-150 segundos por generación

Para qué sirve la API Fast

Si estás creando una app, herramienta o servicio que genera vídeo para usuarios, ya sea un planificador de redes sociales, una plataforma de automatización de marketing, un motor de contenido para e-commerce o una herramienta creativa interna, la API de Seedance 2.0 Fast es el endpoint de calidad cinematográfica más económico sobre el que puedes construir en 2026.

Misma calidad visual que Seedance 2.0 estándar. Menor coste por segundo. Mayor rendimiento de cómputo. Diseñada para integrarse en flujos de trabajo que producen vídeo en volumen.

El usuario objetivo habitual es un desarrollador o equipo que necesita generar vídeo de forma programática a partir de la entrada del usuario, no un creador individual que genera un clip a la vez a través de la interfaz.

Los dos endpoints

Endpoint de texto a vídeo:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/text-to-video

Genera un vídeo a partir de un prompt de texto. No se necesita imagen de origen.

Endpoint de imagen a vídeo:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/image-to-video

Genera un vídeo a partir de una imagen de origen con un prompt de movimiento.

Ambos endpoints aceptan cuerpos de solicitud similares y devuelven el mismo formato de respuesta. Elige según si tienes una imagen de origen que animar.

Autenticación

Cada solicitud necesita una clave API en la cabecera Authorization. Genera una clave desde tu Panel de Arteza.

Authorization: Bearer YOUR_API_KEY

Las claves están vinculadas a tu cuenta y se deducen de tu saldo de créditos. Rótalas según sea necesario desde el panel.

Formato de solicitud: texto a vídeo

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "Slow dolly in on a ceramic coffee cup on a wooden cafe table, morning window light, shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parámetros:

• prompt (obligatorio, cadena): El prompt de texto que describe el vídeo deseado.
• duration (obligatorio, entero): Duración del clip en segundos. Rango: 4-15.
• aspect_ratio (obligatorio, cadena): Uno de "16:9", "9:16", "1:1".

Formato de solicitud: imagen a vídeo

POST /api/v1/bytedance/seedance-2.0/fast/image-to-video
{
  "image_url": "https://your-cdn.com/source-image.jpg",
  "prompt": "Slow push in with shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parámetros:

• image_url (obligatorio, cadena): URL públicamente accesible de la imagen de origen. Formatos admitidos: JPG, PNG, WebP.
• prompt (obligatorio, cadena): Prompt de movimiento que describe cómo animar la imagen.
• duration (obligatorio, entero): Duración del clip en segundos. Rango: 4-15.
• aspect_ratio (obligatorio, cadena): Debe coincidir con la relación de aspecto de la imagen de origen para obtener los mejores resultados.

Formato de respuesta

Ambos endpoints devuelven un ID de trabajo asíncrono:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "queued",
  "estimated_seconds": 45,
  "cost_credits": 242
}

Consulta el endpoint de estado hasta que el trabajo esté completo:

GET /api/v1/jobs/sdf_2026_abc123xyz

Una respuesta completada:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/output/sdf_2026_abc123xyz.mp4",
  "duration_seconds": 5,
  "resolution": "720p",
  "credits_consumed": 242
}

Descarga la video_url y tendrás tu archivo MP4.

Ejemplo completo en Python

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://arteza.ai/api/v1"

def generate_fast_video(prompt, duration=5, aspect_ratio="16:9"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Enviar trabajo de generación
    response = requests.post(
        f"{BASE_URL}/bytedance/seedance-2.0/fast/text-to-video",
        headers=headers,
        json={
            "prompt": prompt,
            "duration": duration,
            "aspect_ratio": aspect_ratio
        }
    )
    job = response.json()
    job_id = job["job_id"]
    print(f"Trabajo en cola: {job_id}, estimado {job['estimated_seconds']}s")
    
    # Consultar estado hasta completar
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Completado: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generación fallida: {status.get('error')}")
        else:
            print(f"Estado: {status['status']}")

# Uso
video_url = generate_fast_video(
    "Slow tracking shot of a golden retriever running through autumn leaves, golden hour, cinematic 35mm film look",
    duration=5,
    aspect_ratio="16:9"
)

Ejemplo completo en JavaScript

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://arteza.ai/api/v1';

async function generateFastVideo(prompt, duration = 5, aspectRatio = '16:9') {
  const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  };

  // Enviar trabajo de generación
  const submitRes = await fetch(
    `${BASE_URL}/bytedance/seedance-2.0/fast/text-to-video`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, duration, aspect_ratio: aspectRatio })
    }
  );
  const job = await submitRes.json();
  console.log(`Trabajo en cola: ${job.job_id}`);

  // Consultar estado hasta completar
  while (true) {
    await new Promise(r => setTimeout(r, 10000));
    const statusRes = await fetch(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers }
    );
    const status = await statusRes.json();

    if (status.status === 'completed') {
      return status.video_url;
    } else if (status.status === 'failed') {
      throw new Error(`Generación fallida: ${status.error}`);
    }
  }
}

// Uso
const videoUrl = await generateFastVideo(
  'Slow dolly in on a matcha latte in a ceramic cup, morning window light, cinematic 35mm',
  5,
  '9:16'
);

¿Listo para construir con la API? Obtén tu clave API →

Precio por llamada a la API

Cada llamada a la API deduce créditos de tu saldo según la duración:

Los créditos no caducan. Compra en volumen a través del niveles de créditos para una mejor economía por llamada: el nivel Enterprise reduce el coste efectivo aproximadamente un 17%.

Límites de velocidad y rendimiento

La API de Seedance 2.0 Fast permite envíos de trabajos concurrentes dentro de límites razonables. Las cuentas típicas pueden enviar 5-10 trabajos en paralelo sin alcanzar restricciones. Las cuentas del nivel Enterprise pueden solicitar mayor concurrencia.

Los trabajos de generación individuales tardan 30-150 segundos según la duración. Con 5 trabajos concurrentes, puedes producir de forma efectiva un clip cada 15-30 segundos de tiempo real.

Para generación en lotes de gran volumen (50 o más clips), envía en tandas de 5-10, espera a que se completen y luego envía la siguiente tanda. No sobrecargues la API con cientos de solicitudes simultáneas.

Gestión de errores

Respuestas de error más comunes:

400 Bad Request: Parámetros no válidos. Comprueba el rango de duración, los valores de relación de aspecto y la longitud del prompt.

401 Unauthorized: Clave API ausente o no válida.

402 Payment Required: Créditos insuficientes. Recarga desde el panel.

429 Too Many Requests: Límite de velocidad superado. Espera y reintenta.

500 Internal Server Error: Problema temporal del servidor. Reintenta con retroceso exponencial.

Diseña tu integración para gestionar los errores 429 y 500 con lógica de reintento. Un retroceso exponencial sencillo (1 s, 2 s, 4 s, 8 s) cubre la mayoría de los fallos transitorios.

Fast vs. estándar en contexto de API

La elección entre los endpoints de API Fast y estándar es principalmente económica:

• Usa Fast para generación programática de alto volumen, apps sensibles al coste y todo lo que no sea un clip principal.
• Usa el estándar para contenido destacado donde la pequeña ventaja de calidad justifica el 20% de coste adicional.

La mayoría de las apps usan Fast por defecto. El endpoint estándar se reserva normalmente para funciones de «nivel premium» o solicitudes específicas de los usuarios.

URLs de los endpoints:

• Fast texto: bytedance/seedance-2.0/fast/text-to-video
• Fast imagen: bytedance/seedance-2.0/fast/image-to-video
• Estándar texto: bytedance/seedance-2.0/text-to-video
• Estándar imagen: bytedance/seedance-2.0/image-to-video

Soporte de webhooks

Para trabajos de larga duración, el sondeo continuo es ineficiente. La API de Seedance 2.0 Fast admite callbacks por webhook: incluye una webhook_url en el cuerpo de tu solicitud y recibirás un POST cuando el trabajo se complete:

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "webhook_url": "https://your-app.com/api/seedance-callback"
}

Tu endpoint de webhook recibe el mismo payload JSON que devolvería el endpoint de estado al completarse. Implementa idempotencia, ya que los webhooks pueden reintentar en caso de fallo.

Preguntas frecuentes, respuestas rápidas

¿Cuántos trabajos concurrentes puedo enviar? Cuentas típicas: 5-10. Enterprise: negociable.

¿Se deducen créditos por trabajos fallidos? No. Los trabajos fallidos reembolsan los créditos automáticamente.

¿Puedo cancelar un trabajo en curso? Sí, mediante POST /api/v1/jobs/{job_id}/cancel. Se reembolsan los créditos si se cancela antes de completarse.

¿En qué formato está el resultado? MP4, vídeo H.264, audio AAC, resolución 720p.

¿Cuánto tiempo son válidas las URLs de salida? Las URLs del CDN de salida son válidas durante 7 días. Descárgalas y guárdalas en tu propio sistema para uso a largo plazo.

¿Hay un modo sandbox o de prueba? No hay un sandbox dedicado. Usa tus 10 créditos gratis de registro para probar. El plan Starter de $5 también es una forma de bajo riesgo de construir contra endpoints reales.

Empieza a construir con la API de Seedance 2.0 Fast

La API es deliberadamente sencilla: dos endpoints, precios deterministas, modelo de trabajo asíncrono y un techo de calidad que iguala al nivel insignia de Seedance 2.0. Úsala para herramientas de redes sociales, automatización de marketing, plataformas de creadores, motores de contenido para e-commerce o apps creativas internas. La economía unitaria hace que la generación de vídeo sea finalmente viable como funcionalidad dentro de otros productos.

¿Listo para construir? Obtén tu clave API →

Sigue leyendo: Guía completa de Seedance 2.0 Fast • Precios de Seedance 2.0 Fast • Creación por lotes con Seedance 2.0 Fast