回调安全规则

异步任务可通过 webhook_url 接收终态通知。URL 必须是公网可访问的 HTTPS 地址。

URL 校验

规则	说明
协议	必须使用 HTTPS。
禁止地址	localhost、127.0.0.1、私网地址、回环地址、内部域名。
数据格式	服务端以 POST JSON 方式发送精简的任务终态通知对象，不包含完整任务结果。
失败处理	回调失败重试策略以研发最终实现为准。

任务到达终态后，服务端向 webhook_url 发送以下精简通知。

{
  "TaskID": "<task_id>",
  "TenantID": "<tenant_id>",
  "Status": "SUCCESS",
  "CallbackURL": "https://example.com/webhook"
}

字段	类型	说明
`TaskID`	string	任务 ID，用于调用任务查询接口获取完整结果。
`TenantID`	string	租户 ID。
`Status`	string	任务终态，可能值为 `SUCCESS`、`FAILED`。
`CallbackURL`	string	本次回调命中的 `webhook_url`；它是回调地址，不是结果 URL。

回调请求体使用 PascalCase 命名，与 /v1 API 的 snake_case 字段不同。收到通知后，使用 TaskID 调用 GET /v1/audio/tasks/{task_id} 获取完整任务结果。