Seedance 1.5 Pro API: video NSFW sin censura, cámara fija

bytedance/seedance-1.5-pro/image-to-video

El image-to-video de Seedance 1.5 Pro de ByteDance arranca el clip desde una imagen fija que aportas y la anima. Los clips duran de 4 a 12 segundos a 480p, 720p o 1080p con audio nativo, y un bloqueo de cámara mantiene el encuadre tal como lo compusiste.

Desde $0.011/s

Ejecutar modelo Ver API

Enviar una solicitud

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 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-1.5-pro/image-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "generate_audio": true,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p"
  }
}'

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

image_urlstringObligatorio

Enlace público y de descarga directa al primer fotograma; obligatorio. Fija la composición, el aspecto del sujeto, el etalonaje y el techo de calidad del clip: una fuente blanda o muy comprimida se nota ampliada en movimiento. El texto, las marcas de agua y los logotipos de la foto viajan al video, así que límpialos antes siempre que puedas. Mantén el archivo por debajo de 10 MB, en JPEG, PNG o WebP.

Valor predeterminado: Sin especificar
Restricciones: contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

promptstringObligatorio

Obligatorio, y debería contar qué pasa después del fotograma en vez de repetir lo que ya se ve: la acción, el paso del tiempo, el sonido. Con camera_fixed en true, mantén dentro del encuadre todo movimiento que describas: una instrucción de cámara y una cámara bloqueada tiran en direcciones opuestas. Como la foto ya fija la imagen, esta es además la vía que sobrevive a los briefs sin censura.

Valor predeterminado: Sin especificar
Restricciones: minLength:3

seedintegerOpcional

Entero de 0 a 2147483647 para el arranque aleatorio; si lo omites, cada ejecución saca el suyo. Mantenlo fijo mientras cambias una sola cosa a la vez para ver qué hizo ese cambio: conserva el ruido inicial, no el clip fotograma a fotograma. Disponible en 480p y 720p; una solicitud a 1080p que lo incluya se rechaza. No afecta el costo.

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

camera_fixedbooleanOpcional

Bloquea la cámara, false por defecto. Ponlo en true y el encuadre se queda quieto mientras el sujeto se mueve dentro: ideal para planos de producto y placas destinadas a un fondo estático. Déjalo en false cuando quieras un acercamiento, una panorámica o un basculamiento, y dilo en el prompt.

Valor predeterminado: false

generate_audiobooleanOpcionalAfecta al precio

Determina si se renderiza una banda sonora nativa sincronizada con la imagen. Viene activa por defecto y se tarifa en un escalón superior; desactívala para bucles de producto mudos o cuando el sonido se añade en posproducción.

Valor predeterminado: true

duration_secondsintegerOpcionalAfecta al precio

Duración en segundos enteros, de 4 a 12, con 5 por defecto, y es la cantidad facturada. Cuanto más dura un plano, más se aleja de su fotograma de origen, así que confirma el movimiento a 4 o 5 segundos antes de alargar.

Valor predeterminado: 5
Restricciones: minimum:4
maximum:12

resolutionstringOpcionalAfecta al precio

Resolución de salida, 720p por defecto y 1080p como máximo; aquí no se ofrece nada más alto. Fija un escalón de tarifa. Ten en cuenta que solo gobierna el formato entregado: no va a rescatar un fotograma de origen blando.

Valor predeterminado: "720p"
Valores permitidos: "480p""720p""1080p"

aspect_ratiostringOpcional

Encuadre de salida, seis valores fijos, 16:9 por defecto. En esta generación no hay opción adaptativa, así que un desajuste con la fuente se resuelve reencuadrando a la proporción pedida y el sujeto puede perder sus márgenes. Ajustarse al recorte de la fuente es la ruta fiable.

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

last_image_urlstringOpcional

Fotograma de cierre opcional: envíalo junto con `image_url` y la toma tiene que llegar a esa imagen, lo que vuelve repetibles las transiciones y los pares de antes y después. Dale las mismas proporciones que al fotograma de apertura. Disponible en 480p y 720p; una solicitud a 1080p que lo incluya se rechaza. No afecta el costo.

Valor predeterminado: Sin especificar
Restricciones: contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "16:9",
      "description": "Aspect ratio of the generated video.",
      "enum": [
        "21:9",
        "16:9",
        "4:3",
        "1:1",
        "3:4",
        "9:16"
      ],
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 60,
        "widget": "select"
      }
    },
    "camera_fixed": {
      "default": false,
      "description": "Lock the camera to produce a stable, fixed-position shot.",
      "type": "boolean",
      "x-ui": {
        "affects_price": false,
        "order": 20,
        "widget": "switch"
      }
    },
    "duration_seconds": {
      "default": 5,
      "description": "Clip length in seconds. This is the billed quantity.",
      "maximum": 12,
      "minimum": 4,
      "type": "integer",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 40,
        "unit": "s",
        "widget": "slider"
      }
    },
    "generate_audio": {
      "default": true,
      "description": "Generate a native soundtrack synchronised to the picture.",
      "type": "boolean",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 30,
        "widget": "switch"
      }
    },
    "image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "URL of the image used as the first frame.",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 80,
        "widget": "upload"
      }
    },
    "last_image_url": {
      "contentMediaType": [
        "image/jpeg",
        "image/png",
        "image/webp",
        "image/gif"
      ],
      "description": "Optional closing frame the shot has to land on (480p and 720p).",
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 75,
        "widget": "upload"
      }
    },
    "prompt": {
      "description": "What to generate: subject, action, camera movement and mood.",
      "minLength": 3,
      "type": "string",
      "x-ui": {
        "affects_price": false,
        "order": 90,
        "primary": true,
        "widget": "textarea"
      }
    },
    "resolution": {
      "default": "720p",
      "description": "Output resolution. Super-resolution tiers are not offered.",
      "enum": [
        "480p",
        "720p",
        "1080p"
      ],
      "type": "string",
      "x-ui": {
        "advanced": false,
        "affects_price": true,
        "order": 50,
        "widget": "radio"
      }
    },
    "seed": {
      "description": "Random seed for controlled comparisons. Omit it to let each run pick its own.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer",
      "x-ui": {
        "affects_price": false,
        "order": 10,
        "widget": "number"
      }
    }
  },
  "required": [
    "prompt",
    "image_url"
  ],
  "type": "object",
  "x-pricing": {
    "billingMode": "variant_matrix",
    "variantFields": [
      "resolution",
      "generate_audio"
    ]
  }
}

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-1.5-pro/image-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.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal y scripts de automatización.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrucciones reutilizables para tu asistente de IA.

n8n

Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.

ComfyUI

Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Explorar flujos listos para usar

No hace falta que escribas nada del código anterior. Conecta el servidor MCP una vez y cualquier agente que use MCP — Claude Code, Codex, Cursor, Windsurf, VS Code, Gemini CLI, Cline, LibreChat — podrá ejecutar este modelo por su nombre. También puedes ejecutarlo desde tu terminal con un solo comando.

Dile esto a tu agente

Use bytedance/seedance-1.5-pro/image-to-video to animate ./poster.png — slow push-in, five seconds — and save the clip next to it.

El agente busca el modelo en el catálogo actualizado, sube el archivo local por ti, te muestra la cotización exacta y el cargo máximo, y espera tu confirmación. No se cobra nada hasta que aceptes.

Conéctalo una sola vez

claude mcp add spicyapi -e SPICY_API_KEY=$SPICY_API_KEY \
  -- npx --yes --package=@spicyapi/mcp spicyapi-mcp
npx skills add spicyapi-ai/spicy-skill

La primera línea le da las herramientas al agente; la segunda le da el Skill, las reglas para usarlas: consultar la cotización antes de cobrar, subir los archivos locales en lugar de pegar sus bytes y leer la URL del resultado en vez de adivinarla. Los demás clientes usan el mismo servidor desde su propio archivo de configuración: consulta el área de desarrolladores.

O un comando en tu terminal

npx @spicyapi/cli tasks create --model bytedance/seedance-1.5-pro/image-to-video \
  --input-json '{"aspect_ratio":"16:9","duration_seconds":5,"generate_audio":true,"image_url":"https://example.com/reference.png","prompt":"A slow aerial shot drifting over a misty pine forest at sunrise","resolution":"720p"}' \
  --wait

La entrada usa el esquema de este endpoint, igual que los ejemplos de arriba. --wait consulta el estado hasta que la tarea termina y lo imprime; agrega --yes para omitir la confirmación en CI. Define antes SPICY_API_KEY: una misma clave sirve para la API, la CLI y el servidor MCP.

Archivos locales

npx @spicyapi/cli files upload ./poster.png
# -> spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3

npx @spicyapi/cli tasks create --model bytedance/seedance-1.5-pro/image-to-video \
  --input-json '{"image_url":"spicy://uploads/01k3m8x9q2z4v7n5p6r8s0t1w3"}' \
  --wait

El cuerpo de la solicitud admite URL, no bytes. Sube primero el archivo y pasa el URI spicy:// que devuelve; el nombre del campo de arriba sale del esquema de este endpoint. Un agente conectado por MCP hace ese paso por ti, y por eso la frase anterior puede nombrar ./poster.png directamente. Los archivos ya accesibles por HTTPS público no necesitan subirse.

Cuánto se conservan los resultados

npx @spicyapi/cli tasks create --model bytedance/seedance-1.5-pro/image-to-video \
  --input-json '{…}' --retention 1h --wait

npx @spicyapi/cli tasks get $TASK_ID   # read back the retention that applied

--retention solo acorta el plazo: 30m, 1h, 7d, o 0 para borrar en cuanto la tarea llega a un estado final. Se aplica el plazo más corto entre tu solicitud, los ajustes de tu cuenta y el máximo de la plataforma. Consúltalo en el registro de la tarea en vez de asumir que se aplicó el plazo que pediste. Pedir más tiempo del que permite tu cuenta no tiene efecto.

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y busca Seedance 1.5 Pro · Image 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

Ejemplos de workflows Guía de configuración Código en GitHub

El panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.

<iframe src="https://spicyapi.ai/embed/es/models/seedance-1-5-pro/api?model=bytedance%2Fseedance-1.5-pro%2Fimage-to-video" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir el panel

Playground

Enviar una solicitud

Autenticación de API

Parámetros de entrada

Seguir la tarea

Leer el resultado

SDK e integraciones

Úsalo en ComfyUI