API para desarrolladores

Construye con SeeDanceE2.ai.

Basada en el modelo subyacente Seedance 2.0, nuestra API unifica y encapsula las capacidades de los proveedores upstream para ofrecerlas como una API pública estandarizada.

model: promodel: fastmodel: mini
Contrato de API estable

Integra una sola vez con `pro`, `fast` y `mini`, mientras mantenemos los cambios de proveedores externos detrás del mismo contrato público.

Flujos de texto e imagen

Ejecuta generación de video desde prompts o imágenes a través de una sola superficie de API, sin exponer a los clientes diferencias específicas de proveedores externos.

Trabajos asíncronos, polling y webhooks

Envía una solicitud de generación, consulta el estado del trabajo o recibe un webhook cuando el video esté listo con una respuesta clara de SeeDanceE2.

Contrato público

Una sola superficie de API para la generación de vídeo

La API pública mantiene ocultos a los proveedores upstream. Los desarrolladores integran tres nombres de modelo públicos, un patrón de autenticación y un ciclo de vida de tareas asíncronas.

Autenticación

Claves de API bearer

Envía `Authorization: Bearer sk_seedancee2_live_xxxxx` en cada solicitud.

Ciclo de vida de las tareas

Enviar, consultar, webhook

Crea una tarea de generación asíncrona, consulta por ID o recibe callbacks de finalización.

Uso y créditos

Reservados y cobrados

Las respuestas exponen créditos reservados, cobrados y reembolsados para que la facturación sea auditable.

Nombres de modelo públicos

Usa solo `pro`, `fast` y `mini`

pro

Calidad de producción

Para clips dirigidos al cliente y trabajo de producción estándar.

480p, 720p, 1080p
fast

Iteración más rápida

Para flujos de previsualización y experimentos repetidos con prompts.

480p, 720p
mini

Pruebas de menor coste

Para borradores ligeros y generación con presupuesto ajustado.

480p, 720p
Preguntas sobre la API

Preguntas frecuentes

¿Cómo autentico las solicitudes a la API de generación de vídeo?

Crea una clave de API en tu espacio de trabajo y envíala como token bearer: Authorization: Bearer sk_seedancee2_live_xxxxx en cada solicitud.

¿La API es síncrona o asíncrona?

La generación es asíncrona. Envías una tarea, recibes un ID de tarea y luego consultas el endpoint de estado o registras un webhook para recibir aviso cuando el vídeo esté listo.

¿Qué nombres de modelo puedo solicitar?

Solo los niveles públicos pro, fast y mini. La plataforma enruta cada solicitud al mejor modelo de vídeo subyacente disponible, de modo que tu integración no se rompe cuando cambian los proveedores.

¿Cómo funciona la facturación de la API?

El uso de la API consume el mismo saldo de créditos que la aplicación web. Las respuestas exponen credits_reserved, credits_charged y credits_refunded para que cada llamada sea auditable.

¿La API admite imagen a vídeo además de texto a vídeo?

Sí. Envía un prompt de texto para texto a vídeo, o adjunta la URL de una imagen de referencia para imagen a vídeo; se conserva la composición de la imagen y solo se genera el movimiento descrito.

API pública de vídeo de SeeDanceE2

SeeDanceE2 ofrece una API pública estable para la generación de vídeo. Las integraciones deben usar únicamente los nombres de modelo públicos pro, fast y mini; los detalles de los proveedores upstream permanecen ocultos detrás del contrato de SeeDanceE2.

URL base

https://api.SeeDanceE2.ai

Inicio rápido

  1. Obtén una clave de API del equipo de SeeDanceE2.
  2. Crea una tarea de generación de vídeo.
  3. Consulta la tarea o recibe un webhook cuando finalice.

Ejemplo mínimo con curl:

curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mini",
    "input": {
      "prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    },
    "metadata": {
      "customer_job_id": "job_123"
    }
  }'

Ejemplo mínimo en JavaScript:

const response = await fetch("https://api.SeeDanceE2.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer sk_seedancee2_live_xxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "mini",
    input: {
      prompt: "A cinematic drone shot of waves breaking against black volcanic rocks",
      duration: 5,
      resolution: "720p",
      aspect_ratio: "16:9",
    },
    metadata: {
      customer_job_id: "job_123",
    },
  }),
});

const result = await response.json();
console.log(result);

Ejemplo mínimo en Python:

import requests

response = requests.post(
    "https://api.SeeDanceE2.ai/v1/videos/generations",
    headers={
        "Authorization": "Bearer sk_seedancee2_live_xxxxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "mini",
        "input": {
            "prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
            "duration": 5,
            "resolution": "720p",
            "aspect_ratio": "16:9",
        },
        "metadata": {
            "customer_job_id": "job_123",
        },
    },
    timeout=60,
)

print(response.json())

Autenticación

Todas las solicitudes usan autenticación con token bearer.

Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/json

También puedes enviar la clave en x-api-key, pero se recomienda Authorization: Bearer ....

Claves de API y acceso a modelos

  • Tu clave de API de SeeDanceE2 la emite el equipo de SeeDanceE2 o se genera desde tu perfil.
  • La misma clave de API de SeeDanceE2 funciona con todos los modelos públicos: pro, fast y mini.
  • No necesitas claves de API separadas para Mini, Fast o Pro.
  • Las credenciales de los proveedores upstream las gestiona SeeDanceE2 y nunca son necesarias en las solicitudes del cliente.

Si ya tienes una clave de API de SeeDanceE2 en funcionamiento, cambiar de modelo solo requiere modificar el campo model de la solicitud. Ejemplo:

{
  "model": "mini"
}

a:

{
  "model": "fast"
}

o:

{
  "model": "pro"
}

Modelos públicos

Estos son los nombres de modelo públicos que debe usar tu integración.

ModeloPosicionamientoDuraciónResolución
proGeneración de producción con calidad estándar4-15 s480p, 720p, 1080p
fastIteración rápida y flujos de previsualización4-15 s480p, 720p
miniGeneración de menor coste4-15 s480p, 720p

Las nuevas integraciones deben usar pro, fast y mini.

Relaciones de aspecto admitidas:

16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive

Créditos

Los créditos de la API pública siguen las mismas reglas de descuento visibles en el producto SeeDanceE2.

Fórmula:

credits = duration_seconds * per_second_rate * number_of_outputs

Las imágenes, vídeos y audios de referencia no añaden actualmente recargos adicionales para el cliente. Los valores de créditos reservados y cobrados de la respuesta de la API son la fuente de verdad para cada tarea.

Tarifas por segundo alineadas actualmente con las reglas de facturación del producto SeeDanceE2:

Modelo480p720p1080p
pro10 créditos/s20 créditos/s50 créditos/s
fast8 créditos/s16 créditos/sNo admitido
mini5 créditos/s10 créditos/sNo admitido

Ejemplos:

EscenarioCréditos
mini, 5 s, 720p50
pro, 4 s, 480p40
fast, 10 s, 720p160
pro, 5 s, 720p, 2 imágenes de referencia100

Si una tarea falla y es elegible para reembolso, el payload de estado devuelto mostrará los créditos reembolsados.

Ciclo de vida de las tareas

Estados de tarea que devuelve la API pública:

EstadoSignificado
pendingAceptada y esperando para iniciar
processingEn ejecución
completedFinalizada correctamente
failedFinalizada sin un resultado utilizable

Crear una tarea de vídeo

POST /v1/videos/generations

Campos de nivel superior de la solicitud:

CampoTipoObligatorioDescripción
modelstringSíNombre del modelo público: pro, fast o mini
inputobjectSíParámetros de generación
callback_urlstringNoURL pública de webhook para callbacks de finalización o fallo
metadataobjectNoMetadatos definidos por el cliente que se devuelven en las respuestas de polling y webhook

Campos de entrada:

CampoTipoObligatorioDescripción
promptstringSíPrompt de texto
generation_typestringNoomni_reference o first_and_last_frames; por defecto omni_reference
image_urlsstring[]NoURL de las imágenes de referencia
video_urlstringNoURL de un único vídeo de referencia
video_urlsstring[]NoURL de los vídeos de referencia. No enviar junto con video_url
audio_urlsstring[]NoURL de los audios de referencia
start_image_urlstringNoImagen del primer fotograma para first_and_last_frames
end_image_urlstringNoImagen del último fotograma para first_and_last_frames
durationintegerNoDuración de salida en segundos, 4-15; por defecto 5
resolutionstringNo480p, 720p o 1080p; las resoluciones disponibles dependen del modelo elegido
aspect_ratiostringNo16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive
generate_audiobooleanNoGenera audio sincronizado cuando es compatible
watermarkbooleanNoSolicita una salida con marca de agua
seedintegerNoSemilla determinista
return_last_framebooleanNoIncluye la imagen del último fotograma en el payload de salida

Ejemplo completo:

curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pro",
    "callback_url": "https://example.com/webhooks/seedancee2",
    "input": {
      "prompt": "A cinematic tracking shot through a rain-soaked neon market at night",
      "image_urls": [
        "https://example-cdn.com/reference-1.png",
        "https://example-cdn.com/reference-2.png"
      ],
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true,
      "return_last_frame": true
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }'

Respuesta correcta:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "pending",
    "model": "pro",
    "credits_reserved": 100,
    "created_at": "2026-06-29T10:00:00.000Z"
  }
}

Obtener una tarea de vídeo

GET /v1/videos/generations/{id}

Ejemplo de polling:

const response = await fetch(
  "https://api.SeeDanceE2.ai/v1/videos/generations/vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
  {
    headers: {
      Authorization: "Bearer sk_seedancee2_live_xxxxx",
    },
  }
);

const result = await response.json();
console.log(result);

Respuesta en procesamiento:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "processing",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

Respuesta al completarse:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "completed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "completed_at": "2026-06-29T10:06:20.000Z",
    "credits_charged": 100,
    "output": {
      "video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
      "thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg",
      "last_frame_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

Respuesta de fallo:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "failed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "credits_charged": 0,
    "credits_refunded": 100,
    "error": {
      "code": "generation_failed",
      "message": "The video could not be generated. Please try again with a different prompt.",
      "type": "generation_error"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

Listar tareas de vídeo

GET /v1/videos/generations

Parámetros de consulta admitidos:

CampoTipoDescripción
statusstringFiltra por pending, processing, completed o failed
limitintegerNúmero máximo de resultados. Por defecto 20, máximo 100

Ejemplo:

curl "https://api.SeeDanceE2.ai/v1/videos/generations?status=completed&limit=10" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx"

Listar modelos

GET /v1/models

Ejemplo de respuesta:

{
  "data": [
    {
      "id": "pro",
      "status": "active",
      "resolutions": ["480p", "720p", "1080p"],
      "duration": {
        "min": 4,
        "max": 15
      }
    }
  ]
}

Resumen de uso

GET /v1/usage

Parámetros de consulta admitidos:

CampoTipoDescripción
startstringFiltro opcional de fecha y hora de inicio en formato ISO 8601
endstringFiltro opcional de fecha y hora de fin en formato ISO 8601
limitintegerNúmero máximo de filas de la cronología diaria. Por defecto 30, máximo 365

Ejemplo:

curl "https://api.SeeDanceE2.ai/v1/usage?start=2026-07-01T00:00:00.000Z&end=2026-07-31T23:59:59.999Z&limit=7" \
  -H "Authorization: Bearer sk_seedancee2_live_xxxxx"

Ejemplo de respuesta:

{
  "data": {
    "range": {
      "start": "2026-07-01T00:00:00.000Z",
      "end": "2026-07-31T23:59:59.999Z"
    },
    "summary": {
      "total_jobs": 12,
      "pending_jobs": 1,
      "processing_jobs": 2,
      "completed_jobs": 8,
      "failed_jobs": 1,
      "credits_charged": 280,
      "credits_refunded": 40,
      "net_credits": 240
    },
    "by_model": [
      {
        "model": "mini",
        "total_jobs": 7,
        "pending_jobs": 0,
        "processing_jobs": 1,
        "completed_jobs": 5,
        "failed_jobs": 1,
        "credits_charged": 120,
        "credits_refunded": 20,
        "net_credits": 100
      },
      {
        "model": "pro",
        "total_jobs": 5,
        "pending_jobs": 1,
        "processing_jobs": 1,
        "completed_jobs": 3,
        "failed_jobs": 0,
        "credits_charged": 160,
        "credits_refunded": 20,
        "net_credits": 140
      }
    ],
    "timeline": [
      {
        "date": "2026-07-01",
        "total_jobs": 4,
        "pending_jobs": 0,
        "processing_jobs": 1,
        "completed_jobs": 3,
        "failed_jobs": 0,
        "credits_charged": 100,
        "credits_refunded": 0,
        "net_credits": 100
      }
    ]
  }
}

Webhooks

Si se proporciona callback_url, SeeDanceE2 envía una solicitud POST cuando la tarea alcanza completed o failed.

Cabeceras recomendadas a inspeccionar:

X-Seedancee2-Event: video.generation.completed
X-Seedancee2-Signature: t=1770000000,v1=...

Si la firma de webhooks está activada en tu cuenta, el cuerpo se firma así:

payload_to_sign = "{timestamp}.{raw_json_body}"
signature = hex(hmac_sha256(webhook_secret, payload_to_sign))

Payload de webhook al completarse:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "completed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "completed_at": "2026-06-29T10:06:20.000Z",
    "credits_charged": 100,
    "output": {
      "video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
      "thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

Payload de webhook en caso de fallo:

{
  "data": {
    "id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
    "status": "failed",
    "model": "pro",
    "created_at": "2026-06-29T10:00:00.000Z",
    "credits_charged": 0,
    "credits_refunded": 100,
    "error": {
      "code": "generation_failed",
      "message": "The video could not be generated. Please try again with a different prompt.",
      "type": "generation_error"
    },
    "metadata": {
      "customer_job_id": "job_123",
      "campaign": "launch_week"
    }
  }
}

Guías de entrada

Imágenes:

RequisitoValor
FormatosJPEG, PNG, WebP, BMP, TIFF, GIF
CantidadHasta 9 imágenes de referencia
first_and_last_framesExactamente 2 imágenes

Vídeos:

RequisitoValor
video_url1
video_urlsHasta 3

Audios:

RequisitoValor
audio_urlsHasta 3

Errores

Formato de error:

{
  "error": {
    "code": "insufficient_credits",
    "message": "Your credit balance is too low. Please top up.",
    "type": "billing_error"
  }
}

Códigos de error públicos actuales:

Estado HTTPCódigoTipoDescripción
400invalid_requestinvalid_request_errorParámetros ausentes o no válidos
401invalid_api_keyauthentication_errorLa clave de API falta, no es válida o está desactivada
402insufficient_creditsbilling_errorSaldo de créditos insuficiente
404model_not_foundinvalid_request_errorEl modelo no existe o está inactivo
404task_not_foundinvalid_request_errorEl ID de tarea no existe
500internal_errorapi_errorError inesperado del servidor

Notas de integración

  • Usa solo nombres de modelo públicos como pro, fast y mini.
  • No construyas lógica basada en nombres de proveedores internos, IDs de tarea internos ni hosts de medios internos.
  • Guarda tus propios metadata para poder vincular callbacks y resultados de polling con registros internos del negocio.
  • En producción, prioriza los webhooks para la finalización y mantén el polling como respaldo.