Skip to main content
POST
Cancelar lote
Requiere acceso a la versión preliminar del espacio de trabajo. Consulta Trabajos de vídeo y procesamiento por lotes para la configuración, los webhooks y la gestión de resultados.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Parámetros de ruta

batch_id
string
requerido

ID del lote que se cancela.

Respuesta

Respuesta de estado del lote

id
string
native_batch_id
string | null

ID de lote nativo del proveedor cuando difiere del ID propio de la pasarela.

object
string
endpoint
string
errors
object
input_file_id
string
completion_window
string
status
string
lifecycle_status
enum<string>

Estado normalizado del ciclo de vida asíncrono para consumidores de sondeo, WebSocket y webhooks.

Opciones disponibles:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

Porcentaje aproximado de finalización del lote derivado de los recuentos de solicitudes del proveedor, si están disponibles. Los lotes completados informan 100.

Rango requerido: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

URL de WebSocket para suscribirse a actualizaciones normalizadas del ciclo de vida de trabajos asíncronos.

cancel_url
string<uri> | null

Reservado por compatibilidad; actualmente siempre es null.

results_url
string<uri> | null

URL autenticada de descarga JSONL de Phaseo para lotes compatibles en estado final. Es null durante el procesamiento. Un lote en estado final puede no tener salida. Use una clave API del espacio de trabajo propietario; se aplican los límites de retención del proveedor.

output_file_id
string
error_file_id
string
created_at
integer
in_progress_at
integer
expires_at
integer
finalizing_at
integer
completed_at
integer
failed_at
integer
expired_at
integer
cancelling_at
integer
cancelled_at
integer
request_counts
object
metadata
object
request_id
string
provider
string
session_id
string
webhook
object

Configuración depurada del webhook asíncrono y estado de entrega. Nunca se devuelven secretos; has_secret indica si las entregas firmadas están habilitadas. Las entregas firmadas incluyen las cabeceras x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt y x-phaseo-max-attempts.

next_webhook_retry_at
string | null
last_webhook_progress
number | null
last_webhook_progress_at
string | null
last_webhook_dispatched_at
string | null
finalized_at
string | null
pricing_lines
object[]
usage
object

Uso y coste agregados normalizados tras la finalización.

billing
object
Última modificación el 2 de octubre de 2026