游戏场景识别

最近更新时间:2024-04-09 15:54:34

我的收藏

功能概述

游戏标签功能实现游戏图片场景的识别,返回图片中置信度较高的游戏类别标签。
注意
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名

授权说明

通过子账号使用时,需要授予 ci:CreateAIGameLabelJob权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

该接口为付费服务,使用图像标签计费项,比例为1:2,即执行1次游戏标签将产生2次图片标签用量,详细计费说明可参见 内容识别费用

请求

原图存储在COS:
GET /<ObjectKey>?ci-process=AIGameRec HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
原图来自其他链接:
GET /?ci-process=AIGameRec&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明
Authorization:Auth String ,详情请参见 请求签名 文档。

请求内容

参数名称
描述
是否必选
类型
ObjectKey
图片地址
是(与detect-url二选一)
String
detect-url
您可以通过填写 detect-url 对任意公网可访问的图片进行游戏场景识别。不填写 detect-url 时,后台会默认处理 ObjectKey ;填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKeydetect-url 示例:http://www.example.com/abc.jpg
String

响应

响应包体具体数据内容如下:
参数名称
类型
描述
RecognitionResult
Container
图片游戏标签识别结果
RecognitionResult 节点内容:
参数名称
类型
描述
GameLabels
Container
游戏标签信息
标签信息中包含如下内容:
参数名称
类型
描述
Confidence
Int
该标签的置信度分数,分数越高则该标签准确度越高
FirstCategory
String
一级标签
SecondCategory
String
二级标签
GameName
String
识别出的游戏标签名称

示例

请求

GET /ObjectKey?ci-process=AIGameRec HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Tue, 03 Apr 2019 09:06:15 GMT
Authorization:XXXXXXXXXXXX

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 645
Date: Tue, 03 Apr 2018 09:06:16 GMT
Status: 200 OK
x-cos-request-id: NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****

<RecognitionResult>
<GameLabels>
<Confidence>100</Confidence>
<FirstCategory>游戏</FirstCategory>
<SecondCategory>游戏</SecondCategory>
        <GameName>王者荣耀</GameName>
</GameLabels>
</RecognitionResult>