跳转到内容

接口文档

查询单个任务

按 taskId 查询状态、结果和计费信息。

GET /v1/tasks/{task_id}

任务完成前,content 和附加结果为空。完成后返回回答、来源、附加结果、实际扣除积分和结果版本。

{
"taskId": "550e8400-e29b-41d4-a716-446655440000",
"clientReference": "order-001",
"question": "请介绍某品牌公开发布的核心产品。",
"platformCode": "qianwen",
"options": { "deepAnalysis": false, "output": "answer" },
"state": "completed",
"content": "回答正文。\n\n> **商品|示例商城**\n>\n> [**示例商品**](https://shop.example.com/products/sku-1)\n>\n> [打开商品](https://shop.example.com/products/sku-1)",
"pageHtml": null,
"modelVersion": null,
"observedAt": null,
"sources": [
{
"title": "公开资料",
"url": "https://www.example.com/source",
"summary": null,
"site": "示例网站",
"publishedAt": null
}
],
"products": [
{
"position": 1,
"title": "示例商品",
"url": "https://shop.example.com/products/sku-1",
"urlType": "web",
"deepLink": null,
"trackingUrl": null,
"fallbackUrl": null,
"thumbnail": "https://cdn.example.com/products/sku-1.png",
"mall": "示例旗舰店",
"mallPlatform": "example",
"mallProductId": "product-1",
"skuId": "sku-1",
"shopId": "shop-1",
"price": "99.00",
"priceUnit": "元",
"sales": "已售 1000+",
"sellingPoints": ["官方正品", "次日达"]
}
],
"videos": [],
"media": [],
"reasoningProcess": null,
"searchProcess": null,
"screenshotUrl": null,
"shareUrl": null,
"failure": null,
"chargedPoints": 1,
"revision": 1,
"expired": false,
"createdAt": "2026-08-14T08:00:00Z",
"completedAt": "2026-08-14T08:01:00Z"
}

当平台返回商品、视频、图片、文档或文件时:

  • content 同时包含适合直接展示的 Markdown 卡片,并使用“商品”“视频”“图片”等类型标签。
  • products、videos、media 提供结构化数据。三个数组中的 position 是统一的全局顺序;合并后按 position 升序展示即可还原顺序。
  • 并非每个平台或每次回答都会返回富媒体;没有相应内容时数组为空,可选字段可能是 null。

商品卡主要字段:

字段 含义
position 商品、视频和其他媒体合并后的全局顺序
title 商品标题
url 首选点击地址,可能是网页或 App 深链
urlType web 表示网页;app_deep_link 表示 App 深链
deepLink App 商品深链,需要相应 App 和设备支持
trackingUrl 跟踪或中转地址
fallbackUrl 首选地址不可用时可尝试的备用地址
thumbnail 商品缩略图
mall 店铺或商城名称
mallPlatform 商城平台标识
mallProductId 商城商品编号
skuId SKU 编号
shopId 店铺编号
price 展示价格,不参与接口计费
priceUnit 价格单位或后缀
sales 销量展示文本
sellingPoints 商品卖点列表

点击商品时优先使用 url。urlType: "web" 可在浏览器打开;urlType: "app_deep_link" 需要客户端调用对应 App,失败时可尝试 fallbackUrl。不要根据 mallProductId 自行拼接商城地址。

视频卡返回 position、title、url、cover、author、duration、videoId 和 videoPlatform。其他媒体卡返回 position、mediaType、title、url、thumbnail 和 content。

结果内容默认保留 7 天。过期后 expired 为 true,任务编号、状态和积分仍可查询。

返回结果中的 options.output 保持英文机器值,其中文含义为:

返回值 中文含义
answer 标准回答
screenshot 回答正文及页面截图
share_link 回答正文及可访问的分享链接

chatgpt_web、gemini_web 的 output 固定返回 answer,具体数据形态查看 options.resultFormat:json 表示结构化回答,html 表示网页内容,all 表示两者都返回。