Ir al contenido principal

Con Seedance 2.0 Fast de ByteDance editas material que ya grabaste a partir de una sola instrucción: envía un clip de 2 a 15 segundos como @Video1, describe el cambio y recibe un nuevo render en 480p o 720p en el que el elenco, sus tiempos y el movimiento de cámara se mantienen tal como se filmaron.

Desde $0.045/s

Playground

Enviar una solicitud

Inicio rápido

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY
Resultado de ejemploUsar este ejemplo
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-fast/video-edit",
  "input": {
    "bitrate_mode": "standard",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Parámetros de entrada

Incluye estos campos en el objeto input del cuerpo de la solicitud. Los nombres y tipos coinciden con la API. No supongas un valor predeterminado si no está indicado.

video_urlstringObligatorioAfecta al precio

MP4, de 2 a 15 segundos, de 24 a 60 fps, 50 MB como máximo. Cada fotograma debe tener entre 409,600 y 2,086,876 píxeles y una relación de aspecto entre 0.4 y 2.5, así que el material en 360p y todo lo que supere 1080p se rechaza. Los clips fuera del rango de 2 a 15 segundos se rechazan antes de cualquier cobro.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
format:"uri"
contentMediaType:["video/mp4","video/webm","video/quicktime"]
promptstringObligatorio

Empieza por el cambio y luego enumera lo que no debe moverse: caras, manos, utilería, el tiempo de cada gesto y la trayectoria de la cámara. El clip de origen es @Video1; las imágenes adicionales son @Image1, @Image2 y los archivos de sonido @Audio1, en orden de carga. Redáctalo como una edición de @Video1, porque Fast no tiene interruptor de edición y se guía por tus palabras.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
watermarkbooleanOpcional

Desactivado de forma predeterminada. Actívalo para grabar en el clip editado la marca visible "AI generated" del modelo.

Valor predeterminado
false
bitrate_modestringOpcional

standard (predeterminado) o high. high codifica el archivo entregado con una tasa de bits más alta, con detalles más nítidos y un archivo más pesado; el precio no cambia.

Valor predeterminado
"standard"
Valores permitidos
"standard""high"
return_last_framebooleanOpcional

También devuelve el último fotograma del clip editado como imagen aparte, útil como imagen inicial de un plano siguiente. Desactivado de forma predeterminada.

Valor predeterminado
false
seedintegerOpcional

Entero opcional de 0 a 2147483647. Mantenerlo fijo facilita comparar dos versiones de una misma edición, aunque no garantiza fotogramas idénticos.

Valor predeterminado
Sin especificar
Restricciones
minimum:0
maximum:2147483647
generate_audiobooleanOpcional

Activado de forma predeterminada: Fast compone una banda sonora nueva para la imagen editada. Desactivado: la edición se entrega sin sonido, porque el audio propio del original no se conserva; vuelve a colocarlo en posproducción si lo necesitas.

Valor predeterminado
true
resolutionstringOpcionalAfecta al precio

480p o 720p (predeterminado). El encuadre sigue al original: en nuestras pruebas un clip panorámico volvió en 864×496 a 480p y uno cuadrado en 640×640. Tu elección fija la tarifa por segundo.

Valor predeterminado
"720p"
Valores permitidos
"480p""720p"
reference_audio_urlsarray<string>Opcional

Opcional: hasta 3 archivos de 2 a 15 segundos, 15 segundos en total, que orientan la nueva banda sonora hacia una voz o un ambiente. Solo cuentan con generate_audio activado y no cambian el precio.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:3
reference_image_urlsarray<string>Opcional

Opcional: hasta 9 imágenes fijas que definan el aspecto buscado, como una chaqueta, un objeto, una cara o una carta de color. Señala cada una en el prompt ("la chaqueta de @Image1"); las imágenes no suben el precio.

Valor predeterminado
Sin especificar
Restricciones
minItems:1
maxItems:9

Seguir la tarea

HTTP 202 significa que la tarea se aceptó, no que haya terminado. Guarda el taskId devuelto y consulta esa tarea. No crees otra mientras esperas el resultado.

Solicitud aceptada
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La respuesta de aceptación incluye la estimación para que tu aplicación pueda mostrar el mismo importe en el historial de tareas y en la facturación.

Consultar la tarea
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Empieza consultando cada 2 segundos aproximadamente y ve espaciando los intentos. Párate en un estado final. Si se cae la conexión, consulta el taskId original. Vuelve a crear la tarea solo con la clave de idempotencia y el cuerpo originales.

O recibe el resultado por callback
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Pasa callBackUrl al crear la tarea y recibirás el registro terminado por POST, sin un bucle de consultas de estado. Cada entrega lleva X-Webhook-Timestamp, X-Webhook-Signature y X-Webhook-Payload-Version. La firma es un HMAC-SHA256 en base64 sobre taskId.timestamp.sha256(body), así que debes verificarla con los bytes originales: si analizas el JSON y vuelves a serializarlo, los bytes cambian y la verificación falla. Las entregas fallidas se reintentan, de modo que el mismo taskId puede llegar dos veces; haz que tu manejador sea idempotente. Responde 2xx primero y haz el trabajo después: un manejador lento se trata como una entrega fallida.

Leer el resultado

Procesa output solo cuando state sea succeeded. Si falla, consulta errorCode, errorMessage y request_id. Los costos y estados de ejemplo no representan una factura real.

Ejemplo de respuesta completada
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "bytedance/seedance-2.0-fast/video-edit",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.mp4",
          "mime": "video/mp4",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.mp4?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Para cada archivo disponible, abre o descarga assets[].url directamente, sin la cabecera Authorization de la API. El enlace firmado expira en expiresAt: vuelve a consultar la tarea para renovarlo mientras el archivo siga dentro del periodo de conservación. Un archivo pendiente o no disponible no trae URL. Trata los enlaces firmados como datos privados.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca Seedance 2.0 Fast · Video Edit en el lienzo. El nodo tiene las mismas opciones que esta página y muestra su precio antes de ejecutarse.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi