AI分析 API 接口文档

按所需结果选择接口：描述词分析用于生成作图或视频提示词；商品信息分析用于提取完整商品 JSON。两类任务须分别使用对应的创建和查询接口，任务编号不能混用。

描述词分析

POST/v2/process/result/imageToPrompt/createapplication/json

请求体

typestring必填

应用类型
5、相似图裂变
13、场景裂变
30、图转视频商品分析
69、穿衣套图卖点分析
71、商品套图卖点分析
73、带货口播视频脚本
89、视频复刻提示词

imageUrlListList必填

图片地址列表(图转视频商品分析、套图卖点分析、带货口播视频脚本支持多张，最多6张；视频复刻提示词为参考图片列表，最多6张)

keywordstring可选

关键字
1.场景裂变此参数有效
2.图转视频商品分析商品信息可通过当前字段传入，不能超过2500字符
3.套图卖点分析商品信息可通过当前字段传入
4.带货口播视频脚本商品信息可通过当前字段传入
5.视频复刻提示词商品信息可通过当前字段传入，不能超过2500字符

providerstring可选默认API_PRE_POINT

套图模式需传入提取类型用于区分功能
API_PRE_POINT 卖点分析
API_LAYOUT_DESC 排版描述

refVideoUrlstring可选

参考视频地址(type=89 视频复刻提示词时必填)

saleCountrystring可选

销售国家或地区(type=73 用于生成符合目标市场的带货口播脚本；type=89 用于视频复刻提示词)

targetLanguagestring可选

目标语言(type=73 用于控制带货口播脚本语言；type=89 用于视频复刻提示词)

durationinteger可选

目标视频时长(秒，type=73 用于规划口播内容和分镜；type=89 用于视频复刻提示词)

请求示例（type≠89时）

JSON

{
    "imageUrlList": ["https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1831963161548988416/2025/04/11/1bf6df8e4f4244fab620a804307d5412.jpg?Expires=1749490711&OSSAccessKeyId=LTAI5tHc6aeQ2BxZpF3QTE15&Signature=BOa3Or9gpH0InQxwTQwDBKiy9oU%3D"],
    "type": 69,
    "keyword": "商品信息"
}

图转视频商品分析请求示例（type=30时）

JSON

{
    "type": 30,
    "imageUrlList": [
        "https://example.com/product-image-1.jpg",
        "https://example.com/product-image-2.jpg"
    ],
    "keyword": "商品名称：无线蓝牙耳机；卖点：降噪、长续航、佩戴舒适"
}

带货口播视频脚本请求示例（type=73时）

JSON

{
    "type": 73,
    "imageUrlList": [
        "https://example.com/product-image-1.jpg",
        "https://example.com/product-image-2.jpg"
    ],
    "keyword": "商品名称：无线蓝牙耳机；卖点：降噪、长续航、佩戴舒适",
    "saleCountry": "US",
    "targetLanguage": "English",
    "duration": 15
}

视频复刻提示词请求示例（type=89时）

JSON

{
    "type": 89,
    "refVideoUrl": "https://example.com/reference-video.mp4",
    "imageUrlList": [
        "https://example.com/product-image-1.jpg",
        "https://example.com/product-image-2.jpg"
    ],
    "keyword": "商品名称：无线蓝牙耳机；卖点：降噪、长续航、佩戴舒适",
    "saleCountry": "US",
    "targetLanguage": "English",
    "duration": 15
}

响应体

顶层 code 始终为 JSON number（整数），成功返回 200，失败返回数字错误码，包括 5004（无效参数）、5007（字段校验失败）。客户端统一按数字解析，例如 code === 200；请求成功后仍需查询 data.status 判断任务是否完成。

traceIdstring

链路ID

codeinteger

状态码 200 为成功其他为失败

msgstring

成功/错误描述

msgKeystring

错误描述编码，状态码不等于200时存在

dataobject

对象字段

idinteger

任务id

响应示例

JSON

{
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "code": 200,
  "msg": "成功",
  "data": {
    "id": 123456
  }
}

查询分析结果

POST/v2/process/result/imageToPrompt/infoapplication/json

请求体

idstring必填

任务id

请求示例

JSON

{
  "id": "1930923414987821056"
}

响应体

traceIdstring

链路ID

codeinteger

状态码 200 为成功其他为失败

msgstring

成功/错误描述

msgKeystring

错误描述编码，状态码不等于200时存在

dataobject

对象字段

idstring

任务id

statusstring

状态
1.已创建 2.执行中 3.成功 4.失败.

resultobject

结果

对象字段

contentstring

内容

响应示例

JSON

{
  "traceId": "f6e0fe4f360f78445c2c5d52f2414dea",
  "code": 200,
  "msg": "成功",
  "data": {
    "id": "123",
    "type": 2,
    "status": 3,
    "result": {
      "content": "swimming pool, mother and baby, baby swimming, water splashes, family bonding, aquatic setting, blue water, blurred faces, close-up composition, indoor pool, parenting, mother-child interaction, wet hair, playful mood, natural lighting, infant safety, soft focus, casual attire, recreational activity, poolside."
    }
  }
}

商品信息分析

根据商品图片和可选文字描述提取商品信息，返回完整商品 JSON，适合为后续内容生成准备商品资料。

本接口使用 images、productText，提交后用下方的专用查询接口获取结果。同页「描述词分析」使用 type、imageUrlList、keyword，两类任务的编号和查询接口不能混用。

创建和查询响应的顶层 code 始终为 JSON number（整数）：成功返回 200，失败返回数字错误码，包括 5004（无效参数）、5007（字段校验失败）。与描述词分析接口使用同一类型口径，客户端统一按数字解析，例如 code === 200。

创建任务

POST/image/v2/make/productInfoAnalysisapplication/json

请求体

imagesarray[string]必填

商品图片 URL 列表，至少 1 张、最多 30 张。图片地址须在任务执行期间可访问。

productTextstring可选

补充商品名称、卖点或其它商品说明，帮助分析图片。

请求示例

JSON

{
  "images": [
    "https://example.com/product-front.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "productText": "无线蓝牙耳机，主打降噪、长续航和舒适佩戴"
}

提交后返回什么

data.id 是字符串任务编号，请保存它并查询原任务。code=200 表示请求成功，data.status=2 表示任务仍在分析中。

JSON

{
  "code": 200,
  "msg": "成功",
  "data": {
    "id": "123456789",
    "type": 24,
    "status": 2
  }
}

查询分析结果

POST/image/v2/make/productInfoAnalysis/infoapplication/json

使用与创建任务相同的身份查询，仅允许任务所属团队及用户读取。

请求体

idstring必填

创建商品信息分析任务返回的 data.id，不可为空或仅包含空白字符。

请求示例

JSON

{
  "id": "123456789"
}

返回字段

codeinteger

请求结果码，200 表示请求成功，其它数字表示失败。任务执行状态另看 data.status。

data.idstring

商品信息分析任务编号。

data.typeinteger

任务类型，固定为 24，无需作为请求参数传入。

data.statusinteger

2 分析中、3 成功、4 失败。

data.result.productJsonstring

成功时返回完整商品 JSON 字符串，可用 JSON.parse 解析；内容可为对象或数组。

data.result.textstring

与 productJson 相同的完整 JSON 字符串，读取任一字段即可。

data.errorstring

失败原因，status=4 时查看。

查询结果示例

以下商品内容仅作示例，实际 JSON 字段以分析结果为准。

JSON

{
  "code": 200,
  "msg": "成功",
  "data": {
    "id": "123456789",
    "type": 24,
    "status": 3,
    "result": {
      "productJson": "{\"name\":\"无线蓝牙耳机\",\"features\":[\"降噪\",\"长续航\"]}",
      "text": "{\"name\":\"无线蓝牙耳机\",\"features\":[\"降噪\",\"长续航\"]}"
    }
  }
}

建议每隔 2～3 秒查询一次，直到 status=3 或 4；客户端等待超时不代表任务失败，请保留任务编号并继续查询原任务，避免重复创建。

请及时查询并保存结果。执行超时的任务会被标记为失败；任务不存在时，查询返回 status=4，error 为“异步任务超时或不存在”。

扣费标准

两类接口创建分析任务均为每次 20 点；查询分析结果不额外扣点。