Ir al contenido principal

El endpoint de texto a video de Seedance 2.5 Flash, de ByteDance, convierte la descripción escrita de un plano en un clip de 4–30 segundos en 480p o 720p, con voces, efectos y ambiente generados en la misma pasada. Elige una de seis formas de encuadre o adaptive, y pide el último fotograma como JPEG para iniciar el siguiente plano.

Desde $0.115/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.5-flash/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "output_format": "mp4",
    "duration_seconds": 5
  }
}'

# 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.

promptstringObligatorio

Escribe el sujeto, una acción principal, el movimiento de cámara, la luz y una línea final Audio: que enumere lo que se oye; el prompt de prueba siguió ese orden y el clip coincidió. Pon las palabras habladas entre comillas e indica el idioma antes de ellas. La longitud del prompt no cambia el precio.

Valor predeterminado
Sin especificar
Restricciones
minLength:1
maxLength:20000
watermarkbooleanOpcional

False por defecto. BytePlus, la plataforma en la nube de ByteDance, indica que true añade una marca de contenido generado por IA en la esquina inferior derecha del video, así que déjalo desactivado en los archivos que vayas a editar. Activarla o no deja el costo igual.

Valor predeterminado
false
return_last_framebooleanOpcional

False por defecto. True devuelve además el último fotograma como JPEG (854×480 en nuestra prueba en 480p y 16:9), listo para usarse como image_url cuando continúes el plano en el endpoint de imagen a video. Sin cargo adicional.

Valor predeterminado
false
output_formatstringOpcional

mp4 (por defecto) o mov. BytePlus documenta mov como video H.264 con muestreo de croma yuv444p y audio PCM, lo que se adapta a una línea de tiempo de edición; nuestros clips de prueba fueron mp4. Mismo precio para ambos.

Valor predeterminado
"mp4"
Valores permitidos
"mp4""mov"
generate_audiobooleanOpcional

True por defecto: las voces, los efectos y el ambiente del prompt se producen junto con la imagen, y nuestra prueba devolvió una pista AAC estéreo. False devuelve un archivo sin sonido al mismo precio.

Valor predeterminado
true
duration_secondsintegerOpcionalAfecta al precio

Segundos enteros de 4 a 30, 5 por defecto, cobrados según lo solicitado. Si piensas recortar o encadenar el clip, pide un segundo más de lo que necesitas; nuestra solicitud de 4 segundos devolvió 4,064 segundos.

Valor predeterminado
5
Restricciones
minimum:4
maximum:30
resolutionstringOpcionalAfecta al precio

480p o 720p, 720p por defecto. Una solicitud horizontal en 480p devolvió 854×480, así que define el plano en 480p y repite el prompt ganador en 720p.

Valor predeterminado
"720p"
Valores permitidos
"480p""720p"
aspect_ratiostringOpcional

16:9 (por defecto), 9:16, 4:3, 3:4, 1:1, 21:9 o adaptive, que deja la forma del encuadre al modelo. Usa una relación fija siempre que un feed o un reproductor espere una; la relación no cambia el precio.

Valor predeterminado
"16:9"
Valores permitidos
"16:9""9:16""4:3""3:4""1:1""21:9""adaptive"

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.5-flash/text-to-video",
    "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.5 Flash · Text to Video 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