营销洞察大模型接口--内容洞察平台-火山引擎

文档中心

立即注册

导航

营销洞察大模型接口

最近更新时间：2024.09.20 13:58:18首次发布时间：2024.09.20 13:58:18

本文档介绍营销洞察模型接口调用方式

概述

营销洞察场景目前有品牌/产品识别模型与卖点识别模型，模型服务需要通过配置白名单的火山引擎IP访问

备注：
模型的开通，详见：模型工厂
模型简介，详见：垂直大模型介绍
接口调用前置操作，详见：调用指南

调用品牌识别大模型API

基本信息

名称	内容
接口地址	/coze_api/item/brand_recognition
请求方式	POST
是否需要鉴权	是
请求流量限制	QPS<2（如需更多资源，请联系我们扩容）

请求参数

Hearder请求参数

字段	类型	是否必填	说明
X-Insight-Biz-Name	string	是	业务名称 -> 即火山账号ID
X-Insight-Access-Token	string	是	API访问凭证access_token
Content-Type	string	是	'application/json'

Body请求参数

字段		类型	是否必填	说明
input	title	string	至少选填一个字段	需要模型提取品牌/产品信息的标题
	asr	string		需要模型提取品牌/产品信息的ASR
	ocr	string		需要模型提取品牌/产品信息的OCR

返回参数

字段				类型	说明
status				int	错误码，具体见错误代码--内容洞察平台-火山引擎
message				string	返回信息
data	answer	brands		array[string]	提取出的品牌列表
		products	product_name	string	产品名
		products	category	string	所属领域类目

调用示例

请求示例

curl --location 'https://insight.volcengineapi.com/coze_api/item/brand_recognition' 
--header 'Content-Type: application/json' 
--header 'X-Insight-Biz-Name: $biz_name' 
--header 'X-Insight-Access-Token: $token' 
--data '{
    "input": {
        "asr": "白象送一箱 白象官方旗舰店 白象送一箱!||白象送一箱|明汤好喝|白象 汤好喝 高汤 熬制高 送整整一箱面 5包入量贩装 中 国面 为中 国 女 足|直播间正在发 熬制高汤包,取代粉包酱包 5包入量贩装 白象中国面 为中国女足 加油!|快来抢 5包入量贩装 白象中国面 26年专注中国好面 为中国女足 加油!|白象送一箱 B 白象官方旗舰店 白象送一箱!",
        "ocr": "白象送一箱，白象送一箱，白象送一箱。哎呀，是的，白象直播间送整整一箱面四个口味，直播间正在发，快抢。",
        "title": "华为手机Pura"
    }
}'

返回示例

{
    "data": {
        "answer": {
            "products": [
                {
                    "product_name": "手机",
                    "category": "3C数码家电"
                },
                {
                    "product_name": "面",
                    "category": "食品饮料"
                },
                {
                    "product_name": "高汤包",
                    "category": "食品饮料"
                }
            ],
            "brands": [
                "华为（huawei）",
                "白象"
            ]
        },
        "token_usage": {
            "prompt_tokens": 2360,
            "completion_tokens": 154,
            "total_tokens": 2514
        }
    },
    "message": "succeed",
    "status": 0
}

调用卖点提取大模型API

基本信息

名称	内容
接口地址	/coze_api/item/selling_point_extract
请求方式	POST
是否需要鉴权	是
请求流量限制	QPS<2（如需更多资源，请联系我们扩容）

请求参数

Hearder请求参数

字段	类型	是否必填	说明
X-Insight-Biz-Name	string	是	业务名称 -> 即火山账号ID
X-Insight-Access-Token	string	是	API访问凭证access_token
Content-Type	string	是	'application/json'

Body请求参数

字段	类型	是否必填	说明
input	string	是	需要模型提取卖点信息的内容

返回参数

字段				类型	说明
status				int	错误码，具体见错误代码--内容洞察平台-火山引擎
message				string	返回信息
data	answer	brands		array[string]	提取出的品牌列表
		products	category	string	所属领域类目
			product	string	产品名
			selling_point	map[string, string]	提取的卖点信息，KV对

调用示例

请求示例

curl --location 'https://insight.volcengineapi.com/coze_api/item/selling_point_extract' 
--header 'Content-Type: application/json' 
--header 'X-Insight-Biz-Name: test' 
--header 'X-Insight-Access-Token: afn3N5yl2xiNYuPdzjMHnUwxvzDHQafy' 
--data '{
    "input": {
        "asr": "白象送一箱 白象官方旗舰店 白象送一箱!||白象送一箱|明汤好喝|白象 汤好喝 高汤 熬制高 送整整一箱面 5包入量贩装 中 国面 为中 国 女 足|直播间正在发 熬制高汤包,取代粉包酱包 5包入量贩装 白象中国面 为中国女足 加油!|快来抢 5包入量贩装 白象中国面 26年专注中国好面 为中国女足 加油!|白象送一箱 B 白象官方旗舰店 白象送一箱!",
        "ocr": "白象送一箱，白象送一箱，白象送一箱。哎呀，是的，白象直播间送整整一箱面四个口味，直播间正在发，快抢。",
        "title": "华为手机Pura"
    }
}'

返回示例

{
    "data": {
        "answer": {
            "brands": [
                "华为（huawei）",
                "白象"
            ],
            "products": [
                {
                    "category": "3C数码家电",
                    "product": "手机",
                    "selling_point": "category not supported"
                },
                {
                    "category": "食品饮料",
                    "product": "高汤包",
                    "selling_point": {
                        "产品功效": "",
                        "产品包装": "",
                        "产品成分": "",
                        "口味口感": "汤好喝",
                        "适用人群": "",
                        "适用场景": ""
                    }
                },
                {
                    "category": "食品饮料",
                    "product": "面",
                    "selling_point": {
                        "产品功效": "",
                        "产品包装": "5 包入量贩装,整箱",
                        "产品成分": "",
                        "口味口感": "汤好喝",
                        "适用人群": "",
                        "适用场景": ""
                    }
                }
            ]
        },
        "token_usage": {
            "prompt_tokens": 2360,
            "completion_tokens": 154,
            "total_tokens": 2514
        }
    },
    "message": "succeed",
    "status": 0
}