商品 AI 分析

curl --request POST \
  --url https://api.ch88.cn/v1/open/product-analysis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product_name": "保湿精华液",
  "image_urls": [
    "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png",
    "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-back.png"
  ]
}
'

import requests

url = "https://api.ch88.cn/v1/open/product-analysis"

payload = {
    "product_name": "保湿精华液",
    "image_urls": ["https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png", "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-back.png"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    product_name: '保湿精华液',
    image_urls: [
      'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png',
      'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-back.png'
    ]
  })
};

fetch('https://api.ch88.cn/v1/open/product-analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 200,
  "data": {
    "analysis": {
      "productName": "保湿精华液",
      "positioning": "面向日常保湿需求的轻盈型面部精华",
      "targetAudience": "关注补水保湿和清爽肤感的成年消费者",
      "coreSellingPoint": "清爽保湿，适合日常护肤搭配",
      "sellingPointDescription": "以产品图片中可确认的信息为基础，突出日常补水和易搭配的使用定位。",
      "useScenarios": [
        "早间护肤",
        "晚间护肤"
      ],
      "category": {
        "general": "美妆个护",
        "specific": "面部精华",
        "searchKeywords": [
          "保湿精华",
          "补水精华",
          "面部护理"
        ]
      },
      "attributes": [
        {
          "label": "包装形式",
          "value": "滴管瓶",
          "evidence": "visible"
        }
      ],
      "aplusFocus": [
        "突出产品质地与使用步骤",
        "展示日常护肤场景"
      ],
      "complianceNotes": [
        "不使用未经证实的功效或医疗表述"
      ],
      "uncertainClaims": [
        "具体容量需根据包装实物确认"
      ]
    },
    "formattedText": "产品名称：保湿精华液\n产品定位：面向日常保湿需求的轻盈型面部精华\n目标人群：关注补水保湿和清爽肤感的成年消费者",
    "output_text": "产品名称：保湿精华液\n产品定位：面向日常保湿需求的轻盈型面部精华\n目标人群：关注补水保湿和清爽肤感的成年消费者"
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "请至少提供 1 张产品图"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 403,
    "type": "permission_error",
    "message": "成员或组织已停用"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 409,
    "type": "conflict_error",
    "message": "成员未分配有效上游密钥"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 429,
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 502,
    "type": "upstream_error",
    "message": "上游服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

POST

https://api.ch88.cn

open

product-analysis

商品 AI 分析

curl --request POST \
  --url https://api.ch88.cn/v1/open/product-analysis \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "product_name": "保湿精华液",
  "image_urls": [
    "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png",
    "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-back.png"
  ]
}
'

import requests

url = "https://api.ch88.cn/v1/open/product-analysis"

payload = {
    "product_name": "保湿精华液",
    "image_urls": ["https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png", "https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-back.png"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    product_name: '保湿精华液',
    image_urls: [
      'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-front.png',
      'https://api.ch88.cn/v1/linggan/media/assets/generated%2Fopen-upload%2Fexample-back.png'
    ]
  })
};

fetch('https://api.ch88.cn/v1/open/product-analysis', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "code": 200,
  "data": {
    "analysis": {
      "productName": "保湿精华液",
      "positioning": "面向日常保湿需求的轻盈型面部精华",
      "targetAudience": "关注补水保湿和清爽肤感的成年消费者",
      "coreSellingPoint": "清爽保湿，适合日常护肤搭配",
      "sellingPointDescription": "以产品图片中可确认的信息为基础，突出日常补水和易搭配的使用定位。",
      "useScenarios": [
        "早间护肤",
        "晚间护肤"
      ],
      "category": {
        "general": "美妆个护",
        "specific": "面部精华",
        "searchKeywords": [
          "保湿精华",
          "补水精华",
          "面部护理"
        ]
      },
      "attributes": [
        {
          "label": "包装形式",
          "value": "滴管瓶",
          "evidence": "visible"
        }
      ],
      "aplusFocus": [
        "突出产品质地与使用步骤",
        "展示日常护肤场景"
      ],
      "complianceNotes": [
        "不使用未经证实的功效或医疗表述"
      ],
      "uncertainClaims": [
        "具体容量需根据包装实物确认"
      ]
    },
    "formattedText": "产品名称：保湿精华液\n产品定位：面向日常保湿需求的轻盈型面部精华\n目标人群：关注补水保湿和清爽肤感的成年消费者",
    "output_text": "产品名称：保湿精华液\n产品定位：面向日常保湿需求的轻盈型面部精华\n目标人群：关注补水保湿和清爽肤感的成年消费者"
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "请至少提供 1 张产品图"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 403,
    "type": "permission_error",
    "message": "成员或组织已停用"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 409,
    "type": "conflict_error",
    "message": "成员未分配有效上游密钥"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 429,
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 502,
    "type": "upstream_error",
    "message": "上游服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "code": 200,
  "data": {
    "analysis": {
      "productName": "保湿精华液",
      "positioning": "面向日常保湿需求的轻盈型面部精华",
      "targetAudience": "关注补水保湿和清爽肤感的成年消费者",
      "coreSellingPoint": "清爽保湿，适合日常护肤搭配",
      "sellingPointDescription": "以产品图片中可确认的信息为基础，突出日常补水和易搭配的使用定位。",
      "useScenarios": [
        "早间护肤",
        "晚间护肤"
      ],
      "category": {
        "general": "美妆个护",
        "specific": "面部精华",
        "searchKeywords": [
          "保湿精华",
          "补水精华",
          "面部护理"
        ]
      },
      "attributes": [
        {
          "label": "包装形式",
          "value": "滴管瓶",
          "evidence": "visible"
        }
      ],
      "aplusFocus": [
        "突出产品质地与使用步骤",
        "展示日常护肤场景"
      ],
      "complianceNotes": [
        "不使用未经证实的功效或医疗表述"
      ],
      "uncertainClaims": [
        "具体容量需根据包装实物确认"
      ]
    },
    "formattedText": "产品名称：保湿精华液\n产品定位：面向日常保湿需求的轻盈型面部精华\n目标人群：关注补水保湿和清爽肤感的成年消费者",
    "output_text": "产品名称：保湿精华液\n产品定位：面向日常保湿需求的轻盈型面部精华\n目标人群：关注补水保湿和清爽肤感的成年消费者"
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

{
  "error": {
    "code": 400,
    "type": "invalid_request_error",
    "message": "请至少提供 1 张产品图"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 401,
    "type": "authentication_error",
    "message": "缺少 Public API Key"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 403,
    "type": "permission_error",
    "message": "成员或组织已停用"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 409,
    "type": "conflict_error",
    "message": "成员未分配有效上游密钥"
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 429,
    "type": "rate_limit_error",
    "message": "请求过于频繁，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 502,
    "type": "upstream_error",
    "message": "上游服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_xxx"
}

{
  "error": {
    "code": 503,
    "type": "service_unavailable_error",
    "message": "服务暂时不可用，请稍后重试",
    "retryable": true
  },
  "request_id": "req_550e8400-e29b-41d4-a716-446655440000"
}

授权

Authorization

string

header

必填

成员级 Public API Key。请填写完整密钥，Mintlify Playground 会自动以 Authorization: Bearer <PUBLIC_API_KEY> 发送。完整明文只在管理后台创建成功时显示一次。

请求体

application/json

image_urls

string<uri>[]

必填

商品图片 URL，至少 1 张、最多 15 张。建议包含正面、背面和关键细节。

Required array length: 1 - 15 elements

product_name

string

已知的商品名称，用于辅助识别；不确定时可以省略。

Maximum string length: 200

示例:

"保湿精华液"

响应

商品分析完成。

code

integer

必填

HTTP 状态码。

data

object

必填

Hide child attributes

data.analysis

object

必填

Hide child attributes

data.analysis.productName

string

必填

AI 识别或请求中提供的商品名称。

data.analysis.positioning

string

必填

商品的市场定位与核心用途概述。

data.analysis.targetAudience

string

必填

适合的目标消费人群。

data.analysis.coreSellingPoint

string

必填

最核心且有依据的商品卖点。

data.analysis.sellingPointDescription

string

必填

对核心卖点的展开说明。

data.analysis.useScenarios

string[]

必填

商品适用的典型场景。

Maximum array length: 8

data.analysis.category

object

必填

Hide child attributes

data.analysis.category.general

string

必填

商品所属一级类目。

data.analysis.category.specific

string

必填

商品所属细分类目。

data.analysis.category.searchKeywords

string[]

必填

适合检索和内容策划使用的类目关键词。

Maximum array length: 5

data.analysis.attributes

object[]

必填

从图片、客户输入或合理推断中得到的商品属性。

Maximum array length: 10

Hide child attributes

data.analysis.attributes.label

string

必填

属性名称，例如包装形式或可见材质。

data.analysis.attributes.value

string

必填

属性值或说明。

data.analysis.attributes.evidence

enum<string>

必填

信息依据。visible 为图片可见，provided 为客户提供，inferred 为 AI 合理推断。

可用选项:

visible,

provided,

inferred

data.analysis.aplusFocus

string[]

必填

适合在 A+ 页面重点表达的内容。

Maximum array length: 6

data.analysis.complianceNotes

string[]

必填

宣传和生图时需要遵守的合规注意事项。

Maximum array length: 8

data.analysis.uncertainClaims

string[]

必填

无法从现有材料确认、需要客户补充核实的信息。

Maximum array length: 10

data.formattedText

string

必填

适合直接展示或继续编辑的中文商品简报。

data.output_text

string

必填

与 formattedText 相同的兼容字段。

request_id

string

必填

本次请求的诊断编号。联系平台排查问题时请提供，不要记录 Public API Key。

示例:

"req_550e8400-e29b-41d4-a716-446655440000"

接口概览

全部接口

商品 AI 分析

授权

请求体

响应