API documentation
查询单个任务
按 taskId 查询状态、结果和计费信息。
This content is not available in your language yet.
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 表示两者都返回。