Skip to main content
GET
获取批处理
需要工作区的预览功能访问权限。有关设置、Webhook 和结果处理,请参阅视频与批处理任务。

授权

Authorization
string
header
必填

Bearer 令牌身份验证

路径参数

batch_id
string
必填

要获取的批处理ID。

响应

批处理状态响应

id
string
native_batch_id
string | null

与网关自有ID不同时的提供商原生批处理ID。

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

供轮询、WebSocket和Webhook使用方使用的标准化异步生命周期状态。

可用选项:
pending,
running,
completed,
failed,
cancelled,
expired
progress
integer

基于提供商请求计数计算的粗略批处理完成百分比(如可用)。已完成批处理报告100。

必填范围: 0 <= x <= 100
polling_url
string<uri>
websocket_url
string<uri>

用于订阅标准化异步任务生命周期更新的WebSocket URL。

cancel_url
string<uri> | null

为兼容性保留;目前始终为null。

results_url
string<uri> | null

受支持终态批处理的需认证Phaseo JSONL下载URL。处理中为null。终态批处理可能没有输出。请使用所属工作区的API密钥;提供商保留期限限制仍然适用。

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

已清理的异步Webhook配置及投递状态。绝不返回密钥;has_secret表示是否启用签名投递。签名投递包含x-phaseo-signature、x-phaseo-timestamp、x-phaseo-event-id、x-phaseo-event-type、x-phaseo-delivery-key、x-phaseo-attempt和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

完成后的标准化汇总使用量和成本。

billing
object
最后修改于 2026年10月2日