Retención y eliminación

La retención tiene dos capas. El plazo máximo de la plataforma es un compromiso público, no un ajuste interno. Dentro de ese máximo, puedes establecer periodos más cortos y eliminar el contenido de una tarea cuando quieras.

La relación entre ambas capas es sencilla: solo puedes acortar los plazos; ningún ajuste tuyo amplía el máximo.

Cuánto tiempo conservamos los datos

Puedes acortar las primeras cuatro filas con los cuatro plazos siguientes: resultados generados, incluidos los medios y el contenido del resultado; medios de cortometrajes; texto del prompt; y archivos subidos.

Los medios de cortometrajes tienen un periodo más largo porque una película de Spicy Studio se construye durante días o semanas, y una escena de la primera semana debe seguir disponible al exportar la película completa. Solo se aplica a tareas iniciadas dentro de un proyecto de cortometraje en Studio; llamar al mismo modelo desde la API, un SDK o el Playground mantiene el máximo de 14 días. El texto del prompt conserva el máximo de 30 días en ambos casos. Los demás plazos son obligaciones de la plataforma o periodos legales y no cambian con tus ajustes.

Cuatro plazos independientes

Responden a cuatro preguntas distintas, no a una pregunta con cuatro ajustes. Los nombres siguientes son los que aparecen en la consola:

Configúralos en Retención, en la página Protección de datos de la consola. Al aceptar una tarea, se establecen sus propios vencimientos de resultados y prompts a partir de estos ajustes y del encabezado siguiente; puedes consultarlos como retention en recordInfo.

«Eliminar al terminar el trabajo» elimina un archivo subido una vez que todas las tareas que lo usan alcanzan un estado final (succeeded / failed / canceled / expired), normalmente en un minuto. No se elimina al crear la tarea, porque un reintento lo necesita. Ten en cuenta la consecuencia: volver a ejecutar la misma imagen exige subirla de nuevo, y un reintento fallará.

Cómo afectan los cambios al contenido existente

Cambiar un plazo no es un simple ajuste «de ahora en adelante». Algunos cambios afectan a tareas que ya ejecutaste y otros no. Así funciona actualmente:

Algunos cambios afectan al pasado porque los vencimientos propios de una tarea se fijan al aceptarla, pero otro proceso de limpieza trabaja en días completos. Toma tu ajuste Texto del prompt, lo redondea hacia arriba a 1, 7 o 30 días y lo aplica a todas las tareas terminadas de la cuenta. Al limpiar una tarea, elimina juntos el texto del prompt y los resultados.

La misma página incluye otra tarjeta, Retención del contenido de trabajos, que controla directamente ese proceso por días:

• Elegir 1 día o 7 días elimina el texto del prompt, los resultados y los archivos generados de todas las tareas que terminaron hace más de ese periodo; sigue haciéndolo con cada tarea al alcanzar esa antigüedad.
• Activar Borrar contenido poco después de finalizar los elimina de todas las tareas terminadas, incluidas las ejecutadas antes de activarlo, aproximadamente una hora después de terminar cada una.
• Las dos tarjetas comparten ajustes: guardar una cambia lo que muestra la otra.

Ajuste por solicitud: X-Spicy-Retention

Si no quieres cambiar los ajustes de la cuenta y solo deseas que esta generación desaparezca antes, envía el encabezado al crear la tarea. Su valor es un número entero de segundos y se aplica a los archivos y el prompt de esta tarea:

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" \
  -H "X-Spicy-Retention: 3600" \
  --data "$TASK_PAYLOAD"

• Solo para acortar. El valor efectivo es min(header, account setting, platform cap). Si un administrador establece una hora para la cuenta, una solicitud individual no puede recuperar 14 días; de lo contrario, el ajuste de cuenta sería una sugerencia.
• 0 es válido y significa «eliminar los archivos en cuanto la tarea alcance un estado final».
• Un valor no válido no hace fallar la solicitud. Un número negativo se limita a 0; un valor superior al máximo se limita al máximo; un valor que no sea un entero decimal se ignora y se aplica el ajuste de cuenta. El valor efectivo siempre se informa como retention en recordInfo. Un encabezado que solo pide ser más conservador no debería romper una generación.
• Qué endpoints lo leen. Lo leen jobs/createTask y jobs/stream. jobs/retry hereda el valor efectivo de la tarea de origen e ignora el encabezado: un reintento es otro intento de lo mismo, y permitirle otro periodo daría dos vencimientos a una misma familia de tareas. jobs/quote no lo lee porque no crea una tarea.

recordInfo devuelve retention para cada tarea; la respuesta de createTask no lo incluye, así que consúltalo cuando la tarea exista:

{
  "retention": {
    "outputsExpireAt": "2026-09-13T12:00:00Z",
    "promptsExpireAt": "2026-09-13T12:00:00Z",
    "source": "header"
  }
}

source indica qué capa decidió: header, esta solicitud; account, el ajuste de cuenta; o platform, el máximo. Enviar el encabezado y recibir igualmente account significa que el ajuste de cuenta ya era más corto que lo solicitado.

Antes de terminar la tarea, outputsExpireAt se calcula desde la aceptación; cuando alcanza un estado final, se recalcula desde la finalización con el mismo periodo. Por eso solo puede desplazarse hacia más tarde, nunca hacia antes. Confía en las fechas de la respuesta en lugar de recalcularlas: el resultado de combinar los tres límites no siempre es el esperado. Además de eliminar tú el contenido, solo un ajuste de cuenta con efecto retroactivo puede borrarlo antes de esas fechas, como se explica arriba.

Eliminar contenido cuando quieras: POST /jobs/purge

Si no quieres esperar al vencimiento:

• En la consola, abre la tarea en Logs y elige Destruir resultados: es la misma acción que el endpoint siguiente.
• Eliminar del historial, en la misma tarea, también borra el prompt y el resultado, programa sus medios para eliminación y además oculta la tarea en tus logs. Está disponible cuando la tarea termina y se liquida la facturación.

Ninguna acción cambia lo que se cobró ni cancela la tarea. Desde el código:

curl -X POST https://api.spicyapi.ai/api/v1/jobs/purge \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"taskId": "job_01k..."}'

La respuesta:

{
  "taskId": "job_01k...",
  "contentState": "purged",
  "purgedAt": "2026-09-13T12:00:00Z",
  "contentRemovedBy": "user",
  "billingRetained": true,
  "mediaDeletionPending": true
}

Algunas reglas:

• Solo tareas en estado final (succeeded / failed / canceled / expired). Espera a que termine una tarea en ejecución: sus archivos todavía no han llegado, y una eliminación parcial es peor que no eliminar. Una tarea de generación no se puede cancelar una vez aceptada, así que no hay una ruta de «cancelar primero y eliminar después».
• Es idempotente y no necesita Idempotency-Key. La idempotencia se basa en taskId: volver a llamar sobre una tarea ya eliminada devuelve igualmente 200, y purgedAt corresponde a la primera eliminación, no a esta llamada. Es seguro reintentar después de un tiempo de espera agotado.
• La respuesta significa «programado», no «ya eliminado». Mientras mediaDeletionPending sea true, contentState ya es purged, pero el proceso en segundo plano no ha terminado de eliminar los objetos; normalmente lo hace en un minuto. Una eliminación síncrona permitiría que un objeto resistente bloqueara toda la solicitud justo cuando necesitas una respuesta clara.
• Una respuesta que siga en present significa que esta llamada no eliminó nada; por ejemplo, porque la tarea está sujeta a una medida de conservación. Puedes reintentar más tarde; deliberadamente no se revela el motivo concreto.
• billingRetained siempre es true. Parece redundante, pero existe porque es el punto que un cliente probablemente interpretaría mal de este endpoint; véase más abajo.

contentState: si existe el contenido y quién lo eliminó

Los detalles de una tarea incluyen un contentState con tres valores:

Los dos últimos incluyen purgedAt, cuándo desapareció el contenido, y contentRemovedBy: system para el proceso de limpieza y user para ti.

Mostrar purged como «vencido» también es incorrecto: uno corresponde a un botón que pulsó el usuario y el otro a nuestra política ejecutada en su momento. Confundirlos lleva a pensar que la plataforma perdió los archivos.

Al vencer se vacían campos, no registros

La limpieza cubre input, output, las URL de callback y el contenido relacionado de eventos y callbacks. El registro de la tarea se conserva indefinidamente: es la única evidencia para una disputa de facturación, y eliminarlo rompería la contabilidad. Después, cada registro contiene unos cientos de bytes de metadatos: ID de tarea, modelo, estado, importe, fechas y clave de origen. La eliminación a petición sigue exactamente la misma regla; solo decides el momento.

Una vez eliminado el contenido:

• Todavía puedes responder «cuánto me cobraron este mes, qué tareas fallaron y qué clave las envió».
• No puedes responder «qué prompt envié o qué clave de objeto contenía el archivo»: recordInfo deja de devolver input y output desde entonces.

Si necesitas los prompts durante más tiempo, guarda tu propia copia. Una medida de conservación activa suspende la eliminación correspondiente y también bloquea la eliminación a petición; ninguna puede recuperar una salida ya borrada físicamente.

El historial de saldo es independiente del contenido

Vaciar input y output de una tarea, al vencer o porque la elimines tú, no modifica recargas, retenciones, liquidaciones, devoluciones de retenciones ni ajustes manuales. Puedes seguir conciliando esos movimientos en la página de facturación de la consola. Los registros de movimientos siguen una política de diez años y no desaparecen al vencer o eliminarse el contenido de una tarea.

Si una solicitud de acceso o eliminación afecta a datos que deben conservarse por una disputa, investigación de seguridad o ley aplicable, nuestra respuesta explicará su alcance y motivo.

Dos cosas que no podemos hacer

La excepción: medidas legales de conservación

Las tareas afectadas por una disputa, una solicitud forense o una obligación legal de notificación se ponen bajo conservación y su cuenta regresiva se detiene hasta levantar la medida. La eliminación a petición no se ejecuta mientras esté activa.

Esto prevalece sobre todas las cifras y ajustes anteriores. No es una excepción oculta: sin un mecanismo de conservación, la primera notificación legal obligaría a incumplir una promesa de retención y después habría que explicar por qué la documentación decía 14 días. Se indica aquí porque corresponde hacerlo.

Qué puedes controlar

• Configura cada plazo según lo que realmente necesites. Son independientes: no cambies las subidas a «Eliminar al terminar el trabajo» solo porque quieras conservar menos tiempo los prompts.
• Descarga antes de acortar. Un ajuste más corto puede afectar a tareas que ya ejecutaste; consulta el efecto de cambiar un ajuste.
• Usa X-Spicy-Retention para solicitudes sensibles puntuales. No hace falta reconfigurar toda la cuenta para una sola generación.
• No envíes lo que no necesites. Las imágenes de referencia y los prompts son los dos elementos más sensibles y los únicos cuyo contenido eliges tú.
• Archiva tus propios resultados. Duran como máximo unos 14 días, o unos 60 días para medios de cortometrajes, y menos si acortas el plazo.
• Guarda una copia de los datos de tu cuenta. Descargar tus datos, en Protección de datos, te entrega un JSON con tu perfil, roles de equipo, detalles de claves de API, nunca los secretos, datos de tareas conservados y registros de facturación. No incluye archivos multimedia: descarga por separado los resultados que necesites.
• No guardes URL de descarga en tu base de datos. Vencen en 20 minutos y no se pueden revocar una vez emitidas. Genera una firmada cuando la necesites; consulta Medios.
• Usa HTTPS para las URL de callback. El contenido enviado incluye estados de tareas y referencias de archivos; HTTP sin cifrar los expone a cualquiera en el trayecto.

No entrenamos con tu contenido

Tus prompts, imágenes de referencia y archivos generados no entran en ningún conjunto de entrenamiento.

El alcance de esa frase importa: se refiere a nosotros. No definimos las políticas de cada modelo; consulta el primer punto anterior.