LAS 算子为您提供异步接口的异步回调（Callback）能力，您可在发起算子调用任务时设置回调参数callback.url，当算子任务状态发生变更后，LAS 会向该 URL 发送 HTTP POST 通知。

• 异步回调（Callback）能力适用于异步任务的算子，通常异步任务算子通过 submit 接口提交任务、poll 接口轮询查询任务处理状态。使用 Callback 能力可减少轮询频率，通过 LAS 主动通知来及时了解任务运行状态。
• 当前异步任务算子陆续开放 Callback 功能，已支持的算子包含：las_asr_pro、las_video_super_resolution、las_video_seedance_replace、las_viral_clip_gen、las_video_scene_seg、las_video_translate。
• Callback 机制是尽力通知机制，不提供严格可靠、严格一次、严格有序保证。在某些特殊场景下，例如由于网络原因等，可能存在接收端没有正常获取到任务状态，LAS 会有一定的重试发送消息的机制，但无法保障一定成功，因此使用 Callback 功能时，建议补充使用 poll 接口的兜底逻辑。

调用流程 #

1. 用户调用 /api/v1/submit 提交异步任务，并传入 callback.url。
2. LAS 返回 task_id，用户保存该 task_id。
3. 任务状态发生变更后，LAS 向用户配置的 callback.url 发起 POST 通知。
4. 用户收到 callback 后按 task_id 幂等处理。
5. 如未收到 callback，用户仍应使用 /api/v1/poll 查询任务状态。

callback.url 配置要求 #

Callback 消息格式与字段 #

LAS 会向用户提供的 callback.url 发起 HTTP POST。

请求头 #

Content-Type: application/json; charset=utf-8

用户侧应以 metadata.task_id 做幂等处理。

Body 字段 #

Callback 消息处理建议 #

1. 解析 JSON body。
2. 校验 metadata.task_id 非空。
3. 查询本地是否已处理该 task_id。
4. 如果已处理，直接返回 2xx。
5. 如果未处理，落库记录完整 callback body。
6. 根据 task_status 更新本地任务状态。
7. 快速返回 2xx，后续较长的处理链路，建议放到用户自己的异步队列。

使用示例 #

submit 提交任务示例 #

{
  "operator_id": "las_xxx",
  "operator_version": "v1",
  "data": {
    "input": "..."
  },
  "callback": {
    "url": "https://example.com/las/callback"
  }
}

Callback 请求示例 #

LAS 会向用户提供的 URL 发起 HTTP POST。

成功任务示例

{
  "metadata": {
    "task_id": "task_xxx",
    "task_status": "COMPLETED",
    "business_code": "0",
    "error_msg": ""
  },
  "data": {
    "result": "..."
  }
}

失败任务示例

{
  "metadata": {
    "task_id": "task_xxx",
    "task_status": "FAILED",
    "business_code": "Server.InternalError",
    "error_msg": "..."
  }
}

以下为您提供主流编程语言下，可搭建 callback 接收服务的代码骨架，您可以直接下载对应 Demo ，基于 Demo 对接开发callback 接收服务。

• Java：
  
  

  las-user-callback-example-java.zip

  未知大小

  
• Python：
  
  

  las-user-callback-example-python.zip

  未知大小

  
• Golang：
  
  

  las-user-callback-example-go.zip

  未知大小