AI驱动的API
产品分类
为产品生成合适的类别及其相关性评分。
通过提供产品名称及其参数,该 API 返回相关类别及其权重,权重为从 1.0 到 10.0 的浮点值,其中 10 代表最高相关性。
该 API 对于构建电子商务平台、产品目录管理系统或批量产品处理工具的开发人员非常有用。它自动化产品分类,确保准确性和一致性。使用案例包括填充产品目录数据、增强产品搜索算法和改进库存管理系统。
您可以通过提供 voice_tone 参数来设置您偏好的写作风格。它可以是像 funny 或 joyous 这样的形容词,甚至可以是著名作家的名字。
在额外的可选参数 context 中,您可以提供其他类别的列表,这些类别将在映射过程中被考虑(例如您当前的电子商务类别)。
您可以通过 max_quantity 参数限制输出。
只有 content 参数是必需的。
AI 工作涉及两个关键步骤:
- 提交AI任务: 通过发送工作请求来启动流程。
- 监控和接收结果: 持续检查作业状态,并在成功完成后获取最终输出。
相关SDK/库
步骤 1. 提交 AI 工作请求
| 属性 | 类型 | 必须 | 描述 |
|---|---|---|---|
| content | String | 是 | 产品名称及其参数以生成类别。 |
| language | String | 否 | 指定输出语言,默认为 English。 |
| max_quantity | Number | 否 | 要生成的产品类别的最大数量。 |
| voice_tone | String | 否 | 首选写作风格参数。可以是形容词,如 funny 或 joyous,甚至是 famous writer 的名字。 |
| context | String | 否 | 在映射过程中将被考虑的其他类别列表(例如,您当前的电子商务类别) |
请求示例:
{
"content": "Razer Blade 16 游戏笔记本:NVIDIA GeForce RTX 4090-第13代英特尔测试24核i9 HX CPU - 16" 双模式Mini LED (4K UHD+ 120Hz & FHD+ 240Hz) - 32GB RAM - 2TB SSD - 紧凑型GaN充电器 - Windows 11",
"language": "English",
"max_quantity":100,
"voice_tone": "neutral",
"context":"Razer Laptops,Razer Gear"
}
响应示例:
{
"status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
"job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}
步骤 2. 监控并获取 AI 工作结果
端点: GET - v1/ecommerce/product_categories/job/status/:uuid
用于检查请求的 API 工作进度的端点。
结果示例:
{
"data": {
"type": "api_job_result",
"id": "6d3fec8c-34f8-4071-a5ba-af14910b4d77",
"attributes": {
"status": "success",
"type": "ecommerce_product_categories",
"result": [
{
"name": "Gaming Laptops",
"weight": 10
},
{
"name": "Razer Laptops",
"weight": 10
},
{
"name": "High-Performance Laptops",
"weight": 9.5
},
{
"name": "Laptops",
"weight": 9
},
{
"name": "Razer Gear",
"weight": 8.5
},
{
"name": "Electronics",
"weight": 8
},
{
"name": "Computers & Accessories",
"weight": 7.5
},
{
"name": "PC Gaming",
"weight": 7
},
{
"name": "Portable Computers",
"weight": 6.5
},
{
"name": "Tech Gadgets",
"weight": 6
}
]
}
}
}