API 文档

BASE URLhttps://redfox.hk

暂无可用的 API 平台

千问纯文本搜索查询任务（含商品信息）

免费调用即将上线

根据任务ID查询搜索结果，包含cardData商品卡片等

单价随接口累计调用量阶梯调整

POSThttps://redfox.hk/story/api/deepSearch/qwaResult

API 密钥获取与配置

获取密钥

调用 API 前，请先在控制台生成 API 密钥并完成配置。在 HTTP 请求头中添加API Key 字段，密钥用于身份校验与额度计费。

获取步骤

前往控制台页面，进入 API 密钥管理模块。
若无已生成的密钥，点击生成新密钥，复制并妥善保存密钥。
在请求头中添加 REDFOX_API_KEY或X-API-KEY字段并填入密钥后即可调用。

API说明

Method：POST

Host：https://redfox.hk

Path：/story/api/deepSearch/qwaResult

请求头

名称	类型	必填	说明	示例
REDFOX_API_KEY	string	否		ak_c4fc9018ffb14ce4ae35dafd92f466c3
Content-Type	string	是	请求体数据类型	application/json

请求参数

参数	类型	必填	说明	示例
taskId	string	是	任务ID（必填）	59611ib9k4mmraw46adef3bb0000000000000001

返回值与结构

统一包装一般为 `code`、`message`/`msg`、`data`（以实际服务为准）。

响应字段

字段	类型	说明	示例
code	integer	响应状态码，2000表示成功	2000
msg	string	响应消息	成功
data	object
failReason	null	失败原因，任务成功时为null，失败时为具体错误描述
result	object	AI导购任务结果
cardData	array	商品卡片列表（推荐的商品，与content中的占位符对应）
image	string	商品主图URL	http://gw.alicdn.com/img/bao/uploaded/i4/i1/2216852932708/O1CN01xjPMLO1VsJfzrjlww_!!2216852932708.jpg
itemId	string	商品ID	891127925313
originPrice	string	商品原价（带￥符号）
pos	integer	卡片排序位置	0
price	string	商品现价	1259.00
sales	string	销量描述	5000+人付款
shopName	string	店铺名称	全新正品大家电商城
sourceSeq	string	商品来源标识（对应content中的占位符）	tao_assistant_rvemhi
title	string	商品标题	海尔10kg滚筒洗衣机冷凝式变频
url	string	商品详情页链接	http://a.m.taobao.com/i891127925313.htm?&ttid=201200%40qwen_iphone_10.4.0&sid=426bd777cbba1f613da1e0426e6f4135
content	string	AI生成的导购推荐正文（Markdown格式，含标题/加粗/列表；[(sourceSeq)]为商品卡片插入占位符，[(auth_1)]为授权引导占位符）	洗烘一体机水挺深，先说清怎么挑不踩坑： - 烘干方式定生死：冷凝式高温70-90℃，伤羊毛真丝；热泵式低温40-60℃护衣…… ### 首推：海尔超薄嵌入款，千元档最稳的选择 10kg洗+6kg烘，BLDC变频电机、一级能效…… [(tao_assistant_rvemhi)] ### 备选一：想要大容量+智能联动，选米家 12kg洗+9kg烘…… [(tao_assistant_hjxygw)] ……为了更准确地为你提供商品、价格、购买渠道及后续订单物流等相关服务，你可以先完成淘宝授权。授权后，我可以更高效地为你查询和补充相关信息。[(auth_1)]
status	string	任务状态：completed-已完成，processing-处理中，failed-失败	completed
taskId	string	异步任务唯一ID，与提交时返回的taskId对应	59611ib9k4mmraw46adef3bb0000000000000001

请求示例

# 暂无示例

响应示例

{
  "code": 2000,
  "data": {
    "failReason": null,
    "result": {
      "cardData": [
        {
          "image": "http://gw.alicdn.com/img/bao/uploaded/i4/i1/2216852932708/O1CN01xjPMLO1VsJfzrjlww_!!2216852932708.jpg",
          "itemId": "891127925313",
          "originPrice": "",
          "pos": 0,
          "price": "1259.00",
          "sales": "5000+人付款",
          "shopName": "全新正品大家电商城",
          "sourceSeq": "tao_assistant_rvemhi",
          "title": "海尔10kg滚筒洗衣机冷凝式变频",
          "url": "http://a.m.taobao.com/i891127925313.htm?&ttid=201200%40qwen_iphone_10.4.0&sid=426bd777cbba1f613da1e0426e6f4135"
        },
        {
          "image": "http://g.search2.alicdn.com/img/bao/uploaded/i4/i4/2218536532979/O1CN01sIkf4hCCGUH1chua_!!4611686018427386867-0-item_pic.jpg",
          "itemId": "1059325369479",
          "originPrice": "￥3299",
          "pos": 1,
          "price": "1472.00",
          "sales": "200+人付款",
          "shopName": "天猫优品官方旗舰店",
          "sourceSeq": "tao_assistant_hjxygw",
          "title": "小米米家洗衣机洗烘12kg白色1.25超高洗净比29种洗烘程序一级能A",
          "url": "http://a.m.taobao.com/i1059325369479.htm?&ttid=201200%40qwen_iphone_10.4.0&sid=37846003cf56370c5581725c17ec5293"
        }
      ],
      "content": "洗烘一体机水挺深，先说清怎么挑不踩坑：\n\n- **烘干方式定生死**：冷凝式高温70-90℃，伤羊毛真丝；热泵式低温40-60℃护衣……\n\n### 首推：海尔超薄嵌入款，千元档最稳的选择\n**10kg洗+6kg烘**，BLDC变频电机、一级能效……\n[(tao_assistant_rvemhi)]\n### 备选一：想要大容量+智能联动，选米家\n**12kg洗+9kg烘**……\n[(tao_assistant_hjxygw)]\n……为了更准确地为你提供商品、价格、购买渠道及后续订单物流等相关服务，你可以先完成淘宝授权。授权后，我可以更高效地为你查询和补充相关信息。[(auth_1)]"
    },
    "status": "completed",
    "taskId": "59611ib9k4mmraw46adef3bb0000000000000001"
  },
  "msg": "成功"
}

常见状态码说明

调用接口时，响应体中的 code 字段对应以下状态码。完整列表请查看 API 状态码说明页。

状态码	说明	排查建议
`400`	请求参数错误	检查请求体、Query 参数是否与文档一致，必填项是否齐全。
`401`	鉴权失败	确认请求头已添加 REDFOX_API_KEY 或 X-API-KEY，且密钥有效、未禁用。
`403`	无权限访问	当前密钥或账号无权调用该接口，请检查密钥状态与接口权限。
`500`	系统内部错误	服务端异常，请稍后重试；持续出现请联系技术支持。
`503`	服务暂不可用	服务维护或短暂过载，请间隔一段时间后重试。
`1001`	缺少必要参数	对照「请求参数」表，补全必填字段。
`1002`	参数格式不正确	检查字段类型与格式（如 URL、日期、枚举值）是否符合说明。
`1003`	参数类型错误	确认 JSON 中数字、字符串、布尔等类型与文档定义一致。
`3103`	密钥不存在	密钥可能已删除或填写错误，请前往控制台核对并重新复制。
`3105`	API Key 已禁用	在控制台启用该密钥，或创建新密钥后替换请求头中的值。
`3201`	积分不足	账户余额不足以支付本次调用，请前往控制台充值后再试。
`3202`	积分账户不存在	账号积分账户异常，请登录控制台确认账户状态。
`4004`	操作过于频繁，请稍后再试	触发频率限制，降低请求频率或增加调用间隔后重试。

调用步骤

在请求头配置REDFOX_API_KEY或X-API-KEY
按 API 说明示例构造请求参数或请求体。
发起请求。
解析 JSON 响应中的 code、message 与 data 字段。

Request（示例代码，仅供参考）

bash

curl -X POST "https://redfox.hk/story/api/deepSearch/qwaResult" \
  -H "REDFOX_API_KEY: your_api_key" \
  -H "REDFOX_API_KEY: ak_c4fc9018ffb14ce4ae35dafd92f466c3" \
  -H "Content-Type: application/json" \
  -d '{
  "taskId": "59611ib9k4mmraw46adef3bb0000000000000001"
}'

Response（示例代码，仅供参考）

json

{
  "code": 2000,
  "data": {
    "failReason": null,
    "result": {
      "cardData": [
        {
          "image": "http://gw.alicdn.com/img/bao/uploaded/i4/i1/2216852932708/O1CN01xjPMLO1VsJfzrjlww_!!2216852932708.jpg",
          "itemId": "891127925313",
          "originPrice": "",
          "pos": 0,
          "price": "1259.00",
          "sales": "5000+人付款",
          "shopName": "全新正品大家电商城",
          "sourceSeq": "tao_assistant_rvemhi",
          "title": "海尔10kg滚筒洗衣机冷凝式变频",
          "url": "http://a.m.taobao.com/i891127925313.htm?&ttid=201200%40qwen_iphone_10.4.0&sid=426bd777cbba1f613da1e0426e6f4135"
        },
        {
          "image": "http://g.search2.alicdn.com/img/bao/uploaded/i4/i4/2218536532979/O1CN01sIkf4hCCGUH1chua_!!4611686018427386867-0-item_pic.jpg",
          "itemId": "1059325369479",
          "originPrice": "￥3299",
          "pos": 1,
          "price": "1472.00",
          "sales": "200+人付款",
          "shopName": "天猫优品官方旗舰店",
          "sourceSeq": "tao_assistant_hjxygw",
          "title": "小米米家洗衣机洗烘12kg白色1.25超高洗净比29种洗烘程序一级能A",
          "url": "http://a.m.taobao.com/i1059325369479.htm?&ttid=201200%40qwen_iphone_10.4.0&sid=37846003cf56370c5581725c17ec5293"
        }
      ],
      "content": "洗烘一体机水挺深，先说清怎么挑不踩坑：\n\n- **烘干方式定生死**：冷凝式高温70-90℃，伤羊毛真丝；热泵式低温40-60℃护衣……\n\n### 首推：海尔超薄嵌入款，千元档最稳的选择\n**10kg洗+6kg烘**，BLDC变频电机、一级能效……\n[(tao_assistant_rvemhi)]\n### 备选一：想要大容量+智能联动，选米家\n**12kg洗+9kg烘**……\n[(tao_assistant_hjxygw)]\n……为了更准确地为你提供商品、价格、购买渠道及后续订单物流等相关服务，你可以先完成淘宝授权。授权后，我可以更高效地为你查询和补充相关信息。[(auth_1)]"
    },
    "status": "completed",
    "taskId": "59611ib9k4mmraw46adef3bb0000000000000001"
  },
  "msg": "成功"
}