用于统一查询图片生成、批量洗图、视频生成、一键详情图任务结果。提交任一能力任务后,保存返回的taskId,通过该接口轮询最终产出。
GET/api/third-party/common/result
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证,用于识别当前账号或租户。 |
Query 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| taskId | string | 是 | 提交任务接口返回的任务 ID,放在 Query 参数中。 |
请求示例
bash
curl -X GET "https://yunfanzhilian.com/api/third-party/common/result?taskId=task_xxxxxxxx" \
-H "X-API-Token: your_token"响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data.taskId | string | - | 提交任务接口返回的任务 ID。 |
| data.status | string | - | 任务状态:pending、processing、completed、failed、partial_failed。 |
| data.results[] | object[] | - | 统一结果列表。图片生成、批量洗图、一键详情图会按任务类型返回对应字段。 |
| data.resultImageUrls | string[] | - | 详情图或图片类结果 URL 列表;有结果时返回。 |
| data.psdUrl | string | - | 一键详情图 PSD 源文件 URL;仅 genDetail 完成后返回。 |
| data.recordId | string | - | 生成记录 ID;单任务类型返回。 |
响应示例
json
{
"code": 200,
"message": "获取结果成功",
"data": {
"taskId": "task_xxxxxxxx",
"status": "completed",
"results": [
{
"fileUrl": "https://your-oss-host/generated/result.png",
"fileType": "image/png"
}
],
"recordId": "67f0c1d6f4a0d2b4d1d0c001"
},
"timestamp": "2026-03-31T09:31:11.000Z"
}