Seedance 1.0 Pro API: Endpoint de Generación de Video Profesional

Si está integrando video en un producto, un flujo de trabajo o una canalización, la interfaz web eventualmente se convierte en un cuello de botella. La API de Seedance 1.0 Pro es el mismo modelo detrás de la interfaz, expuesto como un punto final REST limpio con autenticación de token de portador, precios predecibles por segundo y sondeo de trabajos directo. Esta guía cubre todo lo que necesita para implementarlo en producción.

RESUMEN EJECUTIVO

• API REST para generación de video nativa de 1080p con Seedance 1.0 Pro
• Autenticación: token de portador desde tu panel de control de cuenta
• Facturación: por segundo a $0.24/seg ($0.12 base × margen 2x)
• Patrón: enviar trabajo → sondear estado → descargar MP4
• Ideal para: integraciones SaaS, canalizaciones por lotes, automatización, productos de marca blanca

Lo que te ofrece la API

Todo lo que ofrece la interfaz web de Seedance 1.0 Pro, disponible mediante programación:

• Generación de video de imagen a video con una URL de imagen de origen
• Solicitud de movimiento para dirigir la animación
• Control de duración de 2 a 12 segundos
• Control de fotograma final para transiciones dirigidas
• Bloqueo de cámara activable
• Sondeo de trabajos para estado y URL de resultado
• Salida MP4 en 1080p nativo

Úsalo para productos SaaS que necesiten generación de video integrada, canalizaciones de agencias internas, flujos de trabajo de producción por lotes o automatización de tareas de video repetitivas.

Autenticación

Todas las llamadas a la API se autentican con un token de portador. Genera uno desde tu panel de control de Arteza en arteza.ai.

Authorization: Bearer YOUR_API_KEY

Reglas de seguridad:

• Nunca confirmes claves de API en el control de código fuente
• Rota las claves regularmente
• Usa variables de entorno o un gestor de secretos
• Restringe las claves a orígenes específicos si es posible

Los Puntos Finales Principales

Enviar un Trabajo de Generación

POST /v1/seedance-1-pro/generate

Cuerpo de la solicitud:

{
  "source_image_url": "https://your-cdn.com/source.jpg",
  "prompt": "Slow camera push-in on the subject, warm golden hour light, shallow depth of field",
  "duration_seconds": 6,
  "camera_lock": false,
  "end_frame_url": null
}

Parámetros:

Respuesta:

{
  "job_id": "job_abc123xyz",
  "status": "queued",
  "created_at": "2026-04-10T12:00:00Z",
  "estimated_seconds": 90
}

Verificar el Estado del Trabajo

GET /v1/seedance-1-pro/status/{job_id}

Respuesta (en progreso):

{
  "job_id": "job_abc123xyz",
  "status": "processing",
  "progress": 0.45,
  "created_at": "2026-04-10T12:00:00Z"
}

Respuesta (completada):

{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "resolution": "1920x1080",
  "credits_charged": 144
}

Valores de estado posibles: queued, processing, completed, failed

Descargar el Resultado

Una vez que el estado es completed, el video_url apunta a un archivo MP4 de 1080p. Descárgalo inmediatamente y guárdalo en tu propia infraestructura. No confíes en que la URL sea válida indefinidamente.

Un Ejemplo Completo en Python

import os
import time
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1/seedance-1-pro"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_video(source_image_url, prompt, duration=6, camera_lock=False, end_frame=None):
    payload = {
        "source_image_url": source_image_url,
        "prompt": prompt,
        "duration_seconds": duration,
        "camera_lock": camera_lock,
    }
    if end_frame:
        payload["end_frame_url"] = end_frame
    
    response = requests.post(f"{BASE_URL}/generate", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()["job_id"]

def wait_for_completion(job_id, poll_interval=5, timeout=300):
    start = time.time()
    while time.time() - start < timeout:
        r = requests.get(f"{BASE_URL}/status/{job_id}", headers=HEADERS)
        r.raise_for_status()
        data = r.json()
        
        if data["status"] == "completed":
            return data["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(f"Job failed: {data.get('error', 'unknown')}")
        
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Job {job_id} did not complete within {timeout}s")

def download_video(url, output_path):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    with open(output_path, "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)

# Úsalo
job_id = generate_video(
    source_image_url="https://example.com/product.jpg",
    prompt="Slow camera orbit around the product, studio lighting, 6 seconds",
    duration=6,
    camera_lock=True
)

video_url = wait_for_completion(job_id)
download_video(video_url, "output.mp4")
print(f"Video saved to output.mp4")

Un Ejemplo Completo en Node.js

import fs from 'fs';
import fetch from 'node-fetch';

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1/seedance-1-pro';
const HEADERS = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(opts) {
  const response = await fetch(`${BASE_URL}/generate`, {
    method: 'POST',
    headers: HEADERS,
    body: JSON.stringify(opts)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.job_id;
}

async function waitForCompletion(jobId, { pollInterval = 5000, timeout = 300000 } = {}) {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    const r = await fetch(`${BASE_URL}/status/${jobId}`, { headers: HEADERS });
    const data = await r.json();
    if (data.status === 'completed') return data.video_url;
    if (data.status === 'failed') throw new Error(`Job failed: ${data.error}`);
    await new Promise(res => setTimeout(res, pollInterval));
  }
  throw new Error('Timeout');
}

async function downloadVideo(url, path) {
  const response = await fetch(url);
  const buffer = await response.buffer();
  fs.writeFileSync(path, buffer);
}

// Úsalo
const jobId = await generateVideo({
  source_image_url: 'https://example.com/product.jpg',
  prompt: 'Slow camera orbit around the product, studio lighting, 6 seconds',
  duration_seconds: 6,
  camera_lock: true
});

const videoUrl = await waitForCompletion(jobId);
await downloadVideo(videoUrl, 'output.mp4');
console.log('Saved output.mp4');

¿Quieres calidad de transmisión como esta? Prueba Seedance 1.0 Pro gratis →

Precios y Facturación

Tarifa: $0.24 por segundo de video de salida (24 créditos/segundo)

Los créditos se deducen solo en generaciones exitosas. Los trabajos fallidos no consumen créditos.

Los paquetes de créditos son los mismos que la interfaz web: $10 / $25 / $50 / $100. Consulta el página de precios.

Límites de Velocidad y Concurrencia

Las cuentas estándar tienen límites de velocidad adecuados para cargas de trabajo de integración típicas. Para producción de alto volumen, ponte en contacto con soporte para aumentar los límites.

Orientación general:

• 5, 10 trabajos concurrentes es confiable para la mayoría de cuentas
• Retroceso exponencial en respuestas HTTP 429
• Reintentos a nivel de trabajo en fallas transitorias (hasta 3 intentos)
• Devoluciones de llamada de webhook están disponibles para evitar sondeo excesivo

Webhooks (Opcional)

En lugar de sondear, registra una URL de webhook en tu configuración de cuenta o por solicitud. Cuando se completa un trabajo, Arteza envía un POST a tu URL:

{
  "event": "job.completed",
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "credits_charged": 144,
  "timestamp": "2026-04-10T12:02:15Z"
}

Los webhooks se firman con una firma HMAC en el encabezado X-Seedance-Signature. Verifica antes de confiar en la carga útil.

Manejo de Errores

La API devuelve códigos de estado HTTP estándar:

Los cuerpos de respuesta de error incluyen un campo error con un mensaje legible por humanos y un campo code para manejo programático.

{
  "error": "Source image URL could not be fetched",
  "code": "source_image_unreachable"
}

Requisitos de Imagen de Entrada

• Formatos: PNG, JPEG, WebP
• Tamaño: hasta 10 MB por imagen
• Resolución: mínimo 512x512, cuanto más alto mejor (1080p+ recomendado)
• Acceso a URL: debe ser accesible públicamente por los servidores de Arteza (sin localhost, sin autenticación)

Para imágenes privadas, cárguelas en una URL S3 firmada, CloudFront o similar, y pasa la URL firmada en la solicitud.

Mejores Prácticas

1. Almacena salidas en tu propia infraestructura. No confíes en URLs de Arteza a largo plazo.
2. Registra todo. IDs de trabajo, indicaciones, tiempos, transiciones de estado, errores.
3. Reintentar errores transitorios. Los problemas de red y respuestas 5xx deben reintentar con retroceso exponencial.
4. Valida entradas temprano. Verifica URLs de imagen y rangos de parámetros antes de enviar.
5. Monitorea el saldo de créditos. Alerta cuando caigas por debajo de un umbral.
6. Usa webhooks para producción. El sondeo está bien para cargas de trabajo pequeñas pero es ineficiente a escala.
7. Almacena en caché generaciones idénticas. Si un usuario envía la misma imagen + indicación dos veces, devuelve la URL en caché.

Pruebas y Staging

Comienza cada integración con el nivel de créditos de $10 (1,050 créditos). Eso es suficiente para varias docenas de generaciones de prueba. Construye y prueba tu integración de extremo a extremo antes de comprometerte con niveles de mayor volumen.

Casos de Uso

• Plataformas SaaS: deja que tus usuarios generen video desde sus propios activos
• Comercio electrónico: genera videos de movimiento de productos desde imágenes de catálogo
• Bienes raíces: automatiza la producción de video de listado desde fotos
• Automatización de marketing: video personalizado a escala
• Plataformas de contenido: enriquece artículos, listados o publicaciones sociales con video generado
• Herramientas de video de marca blanca: construye tu propio producto de video de IA en el backend de Arteza

Lectura Relacionada

• Flujos de procesamiento por lotes
• Guía completa de Seedance 1.0 Pro
• Seedance 1.0 Pro para agencias
• Guía de API de Seedance 2.0

Preguntas Frecuentes

¿Puedo usar la API para aplicaciones comerciales? Sí, toda la salida está autorizada para uso comercial.

¿Qué sucede si la generación falla? No se cobran créditos en generaciones fallidas.

¿Durante cuánto tiempo se alojan los videos generados? Los videos están disponibles para descargar durante una ventana de tiempo después de la generación. Descarga y almacena rápidamente.

¿Admiten bibliotecas SDK? Los SDK de comunidad para Python y Node están disponibles. Consulta los documentos para desarrolladores en arteza.ai.

¿Puedo cancelar un trabajo en progreso? Sí, envía DELETE /v1/seedance-1-pro/jobs/{job_id}. Los créditos no se cobran en trabajos cancelados.

¿Cómo obtengo soporte? Envía un correo electrónico al soporte a través de tu panel de control de cuenta para problemas específicos de API.

---

La API de Seedance 1.0 Pro es el camino listo para producción para integrar generación de video de IA de 1080p en tu producto o canalización.

Obtén tu clave de API y comienza a construir → con 50 créditos gratis incluidos en el registro.