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 rápida de Seedance 2.0. Endpoints dedicados para conversión de 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 costos de aproximadamente 20% que importa cuando estás operando a escala.

Aquí está la guía completa del desarrollador.

Resumen ejecutivo

• Endpoints: bytedance/seedance-2.0/fast/text-to-video e fast/image-to-video
• Costo: $0.2419 por segundo, o 194-726 créditos por clip ($1.94-$7.26)
• Respuesta: ID de trabajo asincrónico, sondear para completar, descargar MP4
• Autenticación: Clave API desde tu Panel de control de Arteza
• Velocidad: 30-150 segundos por generación

Para qué sirve la API rápida

Si estás construyendo una aplicación, herramienta o servicio que genera vídeos para usuarios - planificador de redes sociales, plataforma de automatización de marketing, motor de contenido de comercio electrónico, herramienta creativa interna - la API rápida de Seedance 2.0 es el endpoint de calidad cinematográfica más barato sobre el que puedes construir en 2026.

La misma calidad visual que Seedance 2.0 estándar. Costo más bajo por segundo. Mayor rendimiento de cómputo. Construido para integración en flujos de trabajo que producen vídeo en volumen.

El usuario objetivo típico es un desarrollador o equipo que necesita generar vídeo de forma programática basado en entrada del usuario - no un único creador generando 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 requiere 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 comenzando con una imagen de origen cargada 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 para animar.

Autenticación

Cada solicitud necesita una clave API en el encabezado Authorization. Genera una clave desde tu Panel de control de Arteza.

Authorization: Bearer YOUR_API_KEY

Las claves están vinculadas a tu cuenta y se extraen de tu saldo de créditos. Rótálas según sea necesario a través del panel de control.

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 (requerido, string): El prompt de texto describiendo el vídeo deseado.
• duration (requerido, integer): Duración del clip en segundos. Rango: 4-15.
• aspect_ratio (requerido, string): Una 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 (requerido, string): URL accesible públicamente de la imagen de origen. Formatos soportados: JPG, PNG, WebP.
• prompt (requerido, string): Prompt de movimiento describiendo cómo animar la imagen.
• duration (requerido, integer): Duración del clip en segundos. Rango: 4-15.
• aspect_ratio (requerido, string): Debería coincidir con la relación de aspecto de la imagen de origen para mejores resultados.

Formato de respuesta

Ambos endpoints devuelven un ID de trabajo asincrónico:

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

Sondea el endpoint de estado hasta que el trabajo se complete:

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 el video_url y tendrás tu 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"
    }
    
    # Submit generation job
    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"Job queued: {job_id}, estimated {job['estimated_seconds']}s")
    
    # Poll for completion
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Complete: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Usage
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'
  };

  // Submit generation job
  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(`Job queued: ${job.job_id}`);

  // Poll for completion
  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(`Generation failed: ${status.error}`);
    }
  }
}

// Usage
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 sobre la API? Obtén tu clave de 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 expiran. Compra en volumen a través de niveles de créditos para una mejor economía por llamada - el tier empresarial reduce el costo efectivo en aproximadamente 17%.

Límites de velocidad y rendimiento

La API rápida de Seedance 2.0 permite envíos de trabajos concurrentes dentro de límites razonables. Las cuentas típicas pueden enviar 5-10 trabajos en paralelo sin alcanzar limitaciones. Las cuentas tier empresarial pueden solicitar concurrencia más alta.

Los trabajos de generación individual tardan 30-150 segundos según la duración. Con 5 trabajos concurrentes, puedes producir efectivamente un clip cada 15-30 segundos de tiempo de reloj.

Para generación de lotes masivos (50+ clips), envía en olas de 5-10, espera a que se completen, luego envía la siguiente ola. No inundes la API con cientos de solicitudes simultáneas.

Manejo de errores

Respuestas de error comunes:

400 Solicitud incorrecta: Parámetros inválidos. Verifica el rango de duración, valores de relación de aspecto, longitud del prompt.

401 No autorizado: Falta clave API o es inválida.

402 Pago requerido: Créditos insuficientes. Recarga a través del panel de control.

429 Demasiadas solicitudes: Límite de velocidad excedido. Retrocede y reintenta.

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

Construye tu integración para manejar 429 y 500 con gracia con lógica de reintentos. Un retroceso exponencial simple (1s, 2s, 4s, 8s) cubre la mayoría de fallos transitorios.

API rápida vs estándar en contexto

La elección entre endpoints API rápido y estándar es principalmente económica:

• Usa rápido para generación programática de alto volumen, aplicaciones sensibles al costo, y todo lo que no sea un clip destacado.
• Usa estándar para contenido insignia donde la pequeña ventaja de calidad justifica la prima de costo del 20%.

La mayoría de aplicaciones usan rápido por defecto. El endpoint estándar se reserva típicamente para características de "nivel premium" o solicitudes de usuario específicas.

URLs de endpoint:

• Rápido texto: bytedance/seedance-2.0/fast/text-to-video
• Rápido imagen: bytedance/seedance-2.0/fast/image-to-video
• Texto estándar: bytedance/seedance-2.0/text-to-video
• Imagen estándar: bytedance/seedance-2.0/image-to-video

Soporte de webhooks

Para trabajos de larga duración, el sondeo es ineficiente. La API rápida de Seedance 2.0 soporta callbacks de webhooks - incluye un 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 la misma carga JSON que el endpoint de estado devolvería al completarse. Implementa idempotencia - los webhooks pueden reintentar en caso de fallo.

Preguntas comunes, respuestas rápidas

¿Cuál es el máximo de trabajos concurrentes que puedo enviar? Cuentas típicas: 5-10. Empresarial: negociable.

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

¿Puedo cancelar un trabajo en curso? Sí, a través de POST /api/v1/jobs/{job_id}/cancel. Reembolsa créditos si se cancela antes de completarse.

¿Qué formato de archivo tiene la salida? MP4, vídeo H.264, audio AAC, resolución 720p.

¿Cuánto tiempo permanecen válidas las URLs de salida? Las URLs del CDN de salida son válidas por 7 días. Descarga y almacénalas en tu propio sistema para uso a largo plazo.

¿Hay un modo sandbox/prueba? Sin sandbox dedicado. Usa tus 50 créditos gratuitos de registro para probar. El tier inicial de $10 también es una forma de bajo riesgo de construir sobre endpoints reales.

Comienza a construir sobre la API rápida de Seedance 2.0

La API es deliberadamente simple: dos endpoints, precios deterministas, modelo de trabajo asincrónico, y un techo de calidad que coincide con el tier insignia de Seedance 2.0. Construye sobre ella para herramientas de redes sociales, automatización de marketing, plataformas de creadores, motores de contenido de comercio electrónico, o aplicaciones creativas internas. La economía unitaria finalmente hace que la generación de vídeo sea viable como una característica dentro de otros productos.

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

Sigue leyendo: Guía completa de Seedance 2.0 Fast • Precios de Seedance 2.0 Fast • Creación en lote de Seedance 2.0 Fast