IPC内容理解最佳实践

前提条件

1. 请确保已通过CreateIpcOrder - 创建IPC订单下单购买。

2. 请确保已完成环境搭建，详情可参考OpenAPI门户工具。

基础使用

创建IPC算法模板

使用CreateCustomTemplate - 创建用户自定义模板创建模板。示例如下：

# -*- coding: utf-8 -*-
from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

create_custom_template_request = ice20201109_models.CreateCustomTemplateRequest(
    name='ipc_template_001',
    template_config='{"AnalyseTypes":"vlEventDesc","Industry":"common","Scene":"search","TemplateName":"ipc_template_001"}',
    type=11
)
runtime = util_models.RuntimeOptions()
response = client.create_custom_template_with_options(create_custom_template_request, runtime)
print(response)

请求参数：

返回参数：

返回示例：

{
  "CustomTemplate": {
    "CreateTime": "2025-12-22T03:11:02Z",
    "IsDefault": false,
    "ModifiedTime": "2025-12-22T03:11:02Z",
    "Status": "Normal",
    "TemplateConfig": "{\"AnalyseTypes\":\"vlEventDesc\"}",
    "TemplateId": "****a0da83434f0a8d57ffb0415c****",
    "TemplateName": "ipc_template_001",
    "Type": 11,
    "TypeName": "AISmarttagTemplate"
  },
  "RequestId": "******22-1193-5A70-8D4C-E0533C******"
}

提交IPC内容理解任务

使用SubmitSmarttagJob - 提交智能标签作业提交任务。示例如下：

# -*- coding: utf-8 -*-
from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models
import json

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

submit_smarttag_job_request_input = ice20201109_models.SubmitSmarttagJobRequestInput(
    type='Multi',
    media=json.dumps(
        {
            "type": "URL",
            "inputs": [
                "https://xxx.png",
                "https://xxx.png"
            ]
        }
    )
)
submit_smarttag_job_request = ice20201109_models.SubmitSmarttagJobRequest(
    title='ipc测试-001',
    input=submit_smarttag_job_request_input,
    template_id='xxx',
    # params='{"vlEventDescParams":{"deviceId":"camera_001"}}',
)
runtime = util_models.RuntimeOptions()
response = client.submit_smarttag_job_with_options(submit_smarttag_job_request, runtime)
print(response)

请求参数：

vlEventDescParams字段说明：

targetLanguage取值：

返回参数：

返回示例：

{
    "RequestId": "******11-DB8D-4A9A-875B-275798******",
    "JobId": "****d80e4e4044975745c14b****"
}

查询IPC任务结果

使用QuerySmarttagJob - 智能标签任务查询接口查询结果。示例如下：

# -*- coding: utf-8 -*-
from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

query_smarttag_job_request = ice20201109_models.QuerySmarttagJobRequest(
    job_id='xxx'
)
runtime = util_models.RuntimeOptions()
response = client.query_smarttag_job_with_options(query_smarttag_job_request, runtime)
print(response)

请求参数：

返回参数：

Data取值：

返回示例：

{
  "JobStatus": "Success",
  "RequestId": "41B38CF1-C1EC-538E-81FB-791355065538",
  "Results": {
    "Result": [
      {
        "Data": "\"{\\\"brief\\\":\\\"一名成年男性坐在椅子上吃东西，旁边笼子里的两只狗在 走动。\\\",\\\"caption\\\":\\\"在一个铺有砖块的庭院中，一名成年男性（短发，穿米色长袍）坐在椅子上吃东西，旁边有一张放着食物和水瓶的桌子。笼子里有两只灰白色的中型狗在走动。\\\",\\\"action\\\":[\\\"吃东西\\\",\\\"走动\\\"],\\\"label\\\":{\\\"package\\\":false,\\\"human\\\":true,\\\"pet\\\":true,\\\"vehicle\\\":false},\\\"title\\\":\\\"男子庭院吃东西，狗笼内走动\\\",\\\"event\\\":[\\\"成年男性 吃东西\\\",\\\"狗 走动\\\"],\\\"object\\\":[\\\"成年男性\\\",\\\"狗\\\",\\\"桌子\\\",\\\"椅子\\\"]}\"",
        "Type": "EventDesc"
      }
    ]
  },
  "UserData": "{\"fromICE\":true,\"pk\":1346693276669150}"
}

进阶使用

进阶使用支持人物身份识别。

创建人物自注册库

使用CreateRecognitionLib - 创建自定义识别库创建库。示例如下：

# -*- coding: utf-8 -*-
from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

create_recognition_lib_request = ice20201109_models.CreateRecognitionLibRequest(
    algorithm='pedestrian',
    lib_name='ipc_peds_lib_001'
)
runtime = util_models.RuntimeOptions()
response = client.create_recognition_lib_with_options(create_recognition_lib_request, runtime)
print(response)

请求参数：

返回参数：

返回示例：

{
    "LibId": "*************24b47865c6**************",
    "RequestId": "******11-DB8D-4A9A-875B-275798******"
}

创建人物自注册实体

使用CreateRecognitionEntity - 创建自定义识别库中的待识别实体创建实体。示例如下：

# -*- coding: utf-8 -*-
from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

create_recognition_entity_request = ice20201109_models.CreateRecognitionEntityRequest(
    algorithm='pedestrian',
    lib_id='xxx',
    entity_name='小帅'
)
runtime = util_models.RuntimeOptions()
response = client.create_recognition_entity_with_options(create_recognition_entity_request, runtime)
print(response)

请求参数：

返回参数：

返回示例：

{
  "EntityId": "**************544cb84754************",
  "RequestId": "******11-DB8D-4A9A-875B-275798******"
}

创建人物自注册样本

使用CreateRecognitionSample - 注册自定义实体的识别样本创建样本。示例如下：

# -*- coding: utf-8 -*-

from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

create_recognition_sample_request = ice20201109_models.CreateRecognitionSampleRequest(
    algorithm='pedestrian',
    lib_id='xxx',
    entity_id='xxx',
    image_url='https://xxx.png'
)
runtime = util_models.RuntimeOptions()
response = client.create_recognition_sample_with_options(create_recognition_sample_request, runtime)
print(response)

请求参数：

返回参数：

返回示例：

{
    "RequestId": "******11-DB8D-4A9A-875B-275798******",
    "SampleId": "**************4d2ba728e2f**************"
}

创建IPC算法模板

使用CreateCustomTemplate - 创建用户自定义模板创建模板，流程与基础使用相同，但需额外配置人物库。示例如下：

# -*- coding: utf-8 -*-
from alibabacloud_ice20201109.client import Client as ICE20201109Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_ice20201109 import models as ice20201109_models
from alibabacloud_tea_util import models as util_models

# 工程代码建议使用更安全的无AK方式，凭据配置方式请参见：https://help.aliyun.com/document_detail/378659.html。
credential = CredentialClient()
config = open_api_models.Config(
    credential=credential
)
# Endpoint 请参考 https://api.aliyun.com/product/ICE
config.endpoint = 'ice.cn-shanghai.aliyuncs.com'
client = ICE20201109Client(config)

create_custom_template_request = ice20201109_models.CreateCustomTemplateRequest(
    name='ipc_template_001_with_group',
    template_config='{"AnalyseTypes":"vlEventDesc","Industry":"common","Scene":"search","TemplateName":"ipc_template_001_with_group","PedestrianGroupIds":"xxx"}',
    type=11
)
runtime = util_models.RuntimeOptions()
response = client.create_custom_template_with_options(create_custom_template_request, runtime)
print(response)

请求参数：

提交IPC内容理解任务

使用SubmitSmarttagJob - 提交智能标签作业提交任务，流程与基础使用相同。

查询IPC任务结果

使用QuerySmarttagJob - 智能标签任务查询接口查询结果，流程与基础使用相同。相同的输入，描述结果里人物转换成自定义的人物小帅，输出结果为：

{
  "JobStatus": "Success",
  "RequestId": "******F9-82A8-5BC4-B63E-63D756******",
  "Results": {
    "Result": [
      {
        "Data": "\"{\\\"brief\\\":\\\"小帅坐在椅子上吃东西，旁边笼子里有两只狗。\\\",\\\"caption\\\":\\\"在一个铺有砖块的庭院中，一名成年男性（小帅）坐在椅子上吃东西，旁边有一张装有食物和水瓶的桌子。笼子里有两只灰白色的中型狗。\\\",\\\"action\\\":[\\\"吃东西\\\",\\\"其他事件\\\"],\\\"label\\\":{\\\"package\\\":false,\\\"human\\\":true,\\\"pet\\\":true,\\\"vehicle\\\":false},\\\"title\\\":\\\"小帅院中吃东西，狗在笼中\\\",\\\"event\\\":[\\\"成年男性 吃东西\\\",\\\"狗 其他事件\\\"],\\\"object\\\":[\\\"成年男性\\\",\\\"狗\\\",\\\"桌子\\\",\\\"椅子\\\"]}\"",
        "Type": "EventDesc"
      }
    ]
  },
  "UserData": "{\"fromICE\":true,\"pk\":1346693276669150}"
}