Skip to main content
POST
Cancelar lote
Requer acesso à prévia no espaço de trabalho. Consulte Tarefas de vídeo e processamento em lote para configuração, webhooks e tratamento de resultados.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Parâmetros de caminho

batch_id
string
obrigatório

ID do lote a cancelar.

Resposta

Resposta de status do lote

id
string
native_batch_id
string | null

ID nativo do lote no provedor quando difere do ID do gateway.

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

Status normalizado do ciclo de vida assíncrono para consumidores de polling, WebSocket e webhooks.

Opções disponíveis:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

Porcentagem aproximada de conclusão do lote derivada das contagens de solicitações do provedor, quando disponíveis. Lotes concluídos informam 100.

Intervalo obrigatório: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

URL de WebSocket para assinar atualizações normalizadas do ciclo de vida de trabalhos assíncronos.

cancel_url
string<uri> | null

Reservado para compatibilidade; atualmente sempre null.

results_url
string<uri> | null

URL autenticada de download JSONL do Phaseo para lotes suportados em status final. Null durante o processamento. Um lote final pode não ter saída. Use uma chave de API do espaço de trabalho proprietário; aplicam-se os limites de retenção do provedor.

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

Configuração sanitizada do webhook assíncrono e estado de entrega. Segredos nunca são retornados; has_secret indica se entregas assinadas estão habilitadas. Entregas assinadas incluem os cabeçalhos x-phaseo-signature, x-phaseo-timestamp, x-phaseo-event-id, x-phaseo-event-type, x-phaseo-delivery-key, x-phaseo-attempt e 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 e custo agregados normalizados após a finalização.

billing
object
Última modificação em 2 de outubro de 2026