AI 图像处理回调--veImageX-火山引擎

文档中心

立即注册

导航

veImageX

AI 图像处理回调

最近更新时间：2025.11.06 16:14:24首次发布时间：2025.04.03 16:00:09

在 AI 图像处理任务结束后 veImageX 将会把结果回调至您指定的回调地址。您可以通过回调内容，获取 AI 图像处理结果并进行后续的操作。

说明

解析回调时，需要根据 workflow_template_id 的值来解析，以免解析失败。

回调内容

AI 图像处理回调中包含的具体参数如下：

回调参数	说明
callback_type	回调类型，分为条目维度和任务维度两种类型。
callback_args	业务设置的透传回调参数。
queue_id	任务队列 ID。
task_id	提交任务的 ID。该任务由一条或多条 URL/URI 所组成，每条 URL/URI 对应一个 entry_id。
workflow_template_id	模板 ID。附加组件不同，模板 ID 不同，详见 AIGC 大模型超分辨率模板、电商万创模板、智能图像扩展模板、智图像超分辨率（云端）模板、AIGC 图片翻译模板和大模型画质评估模板。
entry_info	条目详情，单个 URL/URI 所在处理任务的具体处理数据。
task_part_info	已废弃。

回调示例

成功回调

{
    "callback_type": "entry",
    "callback_args": "",
    "queue_id": "67d6bc8****abc8f36001583",
    "task_id": "67e0102f6****cf05829611c",
    "workflow_template_id":"system_workflow_ai_super_resolution",
    "entry_info":
    {
        "uri": "tos-i-0nt0sfs8p7/8b3f****bfc8a716ffe568eb3b814c3e.webp",
        "input_object_key": "8b3f3cc3bfc****6ffe568eb3b814c3e.webp",
        "entry_id": "67e0102f6****cf05829611f",
        "status": "Success",
        "ai_result":
        {
            "output": "{\"ObjectKey\":\"veImageX-store/ai_super_resolution/67e0102f6d****f05829611c/8b3f3cc3bfc8a7****e568eb3b814c3e.webp\",\"Size\":38620,\"Format\":\"webp\"}"
        },
        "submit_at": 1742737455,
        "start_at": 1742737460,
        "end_at": 1742737463
    },
    "task_part_info": null
}

失败示例

{
    "callback_type": "entry",
    "callback_args": "",
    "queue_id": "67d6bc8633fabc8f36001583",
    "task_id": "67e00f836de21cf058296117",
    "workflow_template_id":"system_workflow_ai_super_resolution",
    "entry_info":
    {
        "uri": "tos-boe-i-0nt0sfs8p7/8b3f3cc3bfc8a716ffe568eb3b814c3e.webp",
        "input_object_key": "8b3f3cc3bfc8a716ffe568eb3b814c3e.webp",
        "entry_id": "67e00f836de21cf05829611a",
        "status": "Fail",
        "ai_result": null,
        "submit_at": 1742737283,
        "start_at": 1742737310,
        "end_at": 1742737310
    }
}