Claves de API bearer
Envía `Authorization: Bearer sk_seedancee2_live_xxxxx` en cada solicitud.
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.
Integra una sola vez con `pro`, `fast` y `mini`, mientras mantenemos los cambios de proveedores externos detrás del mismo contrato público.
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.
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.
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.
Envía `Authorization: Bearer sk_seedancee2_live_xxxxx` en cada solicitud.
Crea una tarea de generación asíncrona, consulta por ID o recibe callbacks de finalización.
Las respuestas exponen créditos reservados, cobrados y reembolsados para que la facturación sea auditable.
Para clips dirigidos al cliente y trabajo de producción estándar.
Para flujos de previsualización y experimentos repetidos con prompts.
Para borradores ligeros y generación con presupuesto ajustado.
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 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.
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.
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.
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.
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.
https://api.SeeDanceE2.aiEjemplo 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())Todas las solicitudes usan autenticación con token bearer.
Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/jsonTambién puedes enviar la clave en x-api-key, pero se recomienda Authorization: Bearer ....
pro, fast y mini.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"
}Estos son los nombres de modelo públicos que debe usar tu integración.
| Modelo | Posicionamiento | Duración | Resolución |
|---|---|---|---|
pro | Generación de producción con calidad estándar | 4-15 s | 480p, 720p, 1080p |
fast | Iteración rápida y flujos de previsualización | 4-15 s | 480p, 720p |
mini | Generación de menor coste | 4-15 s | 480p, 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, adaptiveLos 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_outputsLas 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:
| Modelo | 480p | 720p | 1080p |
|---|---|---|---|
pro | 10 créditos/s | 20 créditos/s | 50 créditos/s |
fast | 8 créditos/s | 16 créditos/s | No admitido |
mini | 5 créditos/s | 10 créditos/s | No admitido |
Ejemplos:
| Escenario | Créditos |
|---|---|
mini, 5 s, 720p | 50 |
pro, 4 s, 480p | 40 |
fast, 10 s, 720p | 160 |
pro, 5 s, 720p, 2 imágenes de referencia | 100 |
Si una tarea falla y es elegible para reembolso, el payload de estado devuelto mostrará los créditos reembolsados.
Estados de tarea que devuelve la API pública:
| Estado | Significado |
|---|---|
pending | Aceptada y esperando para iniciar |
processing | En ejecución |
completed | Finalizada correctamente |
failed | Finalizada sin un resultado utilizable |
POST /v1/videos/generationsCampos de nivel superior de la solicitud:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
model | string | Sí | Nombre del modelo público: pro, fast o mini |
input | object | Sí | Parámetros de generación |
callback_url | string | No | URL pública de webhook para callbacks de finalización o fallo |
metadata | object | No | Metadatos definidos por el cliente que se devuelven en las respuestas de polling y webhook |
Campos de entrada:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
prompt | string | Sí | Prompt de texto |
generation_type | string | No | omni_reference o first_and_last_frames; por defecto omni_reference |
image_urls | string[] | No | URL de las imágenes de referencia |
video_url | string | No | URL de un único vídeo de referencia |
video_urls | string[] | No | URL de los vídeos de referencia. No enviar junto con video_url |
audio_urls | string[] | No | URL de los audios de referencia |
start_image_url | string | No | Imagen del primer fotograma para first_and_last_frames |
end_image_url | string | No | Imagen del último fotograma para first_and_last_frames |
duration | integer | No | Duración de salida en segundos, 4-15; por defecto 5 |
resolution | string | No | 480p, 720p o 1080p; las resoluciones disponibles dependen del modelo elegido |
aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive |
generate_audio | boolean | No | Genera audio sincronizado cuando es compatible |
watermark | boolean | No | Solicita una salida con marca de agua |
seed | integer | No | Semilla determinista |
return_last_frame | boolean | No | Incluye 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"
}
}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"
}
}
}GET /v1/videos/generationsParámetros de consulta admitidos:
| Campo | Tipo | Descripción |
|---|---|---|
status | string | Filtra por pending, processing, completed o failed |
limit | integer | Nú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"GET /v1/modelsEjemplo de respuesta:
{
"data": [
{
"id": "pro",
"status": "active",
"resolutions": ["480p", "720p", "1080p"],
"duration": {
"min": 4,
"max": 15
}
}
]
}GET /v1/usageParámetros de consulta admitidos:
| Campo | Tipo | Descripción |
|---|---|---|
start | string | Filtro opcional de fecha y hora de inicio en formato ISO 8601 |
end | string | Filtro opcional de fecha y hora de fin en formato ISO 8601 |
limit | integer | Nú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
}
]
}
}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"
}
}
}Imágenes:
| Requisito | Valor |
|---|---|
| Formatos | JPEG, PNG, WebP, BMP, TIFF, GIF |
| Cantidad | Hasta 9 imágenes de referencia |
first_and_last_frames | Exactamente 2 imágenes |
Vídeos:
| Requisito | Valor |
|---|---|
video_url | 1 |
video_urls | Hasta 3 |
Audios:
| Requisito | Valor |
|---|---|
audio_urls | Hasta 3 |
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 HTTP | Código | Tipo | Descripción |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | Parámetros ausentes o no válidos |
| 401 | invalid_api_key | authentication_error | La clave de API falta, no es válida o está desactivada |
| 402 | insufficient_credits | billing_error | Saldo de créditos insuficiente |
| 404 | model_not_found | invalid_request_error | El modelo no existe o está inactivo |
| 404 | task_not_found | invalid_request_error | El ID de tarea no existe |
| 500 | internal_error | api_error | Error inesperado del servidor |
pro, fast y mini.metadata para poder vincular callbacks y resultados de polling con registros internos del negocio.