跳转到主要内容
GET
/
v1
/
predictions
/
{prediction_id}
查询预测任务
curl --request GET \
  --url https://api.shuyou.ai/v1/predictions/{prediction_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": "0",
  "usage": {
    "upstream_cost": 0.039,
    "discount": 0.00975,
    "discount_percent": 0.75,
    "cost": 0.02925
  },
  "data": {
    "task_id": "fa746cb19082452b82fea4f496f4065a",
    "task_status": "success",
    "output": [
      {
        "type": "image",
        "image": "https://cdn.shuyou.ai/model/20a60c33ba954d85a669ee0f24da8e38.png?e=1778427598&token=Lk3Kb36M3K8oq2d5pU6CaYyoud2Au-APFP-ThE8B:cZUtU2t4yclXCeW0X3j0gJ8Oc58="
      }
    ]
  },
  "request_id": "8bd6b5784a1e42b79bf172607f476f56"
}
将 Create Prediction 返回的 data.task_id 作为路径参数 prediction_id 传入。

​
响应字段

字段类型说明
codestring响应状态码，"0" 表示成功。
usageobject计费摘要；任务处理中时可能尚未返回。
usage.upstream_costnumber折扣前上游成本（USD）。
usage.discountnumber折扣金额（USD）。
usage.discount_percentnumber折扣比例（小数，如 0.75 表示 75 折）。
usage.costnumber折扣后的最终计费金额（USD）。
data.task_idstring异步任务 ID。
data.task_statusstring任务状态，如 processing、success、failed。
data.outputarray任务成功时的生成结果。
data.output[].typestring输出媒体类型，如 image、video。
data.output[].imagestring当 type 为 image 时的图片 URL；链接可能有时效。
request_idstring唯一请求 ID，用于排查与支持。
{
  "code": "0",
  "usage": {
    "upstream_cost": 0.039,
    "discount": 0.00975,
    "discount_percent": 0.75,
    "cost": 0.02925
  },
  "data": {
    "task_id": "fa746cb19082452b82fea4f496f4065a",
    "task_status": "success",
    "output": [
      {
        "type": "image",
        "image": "https://cdn.shuyou.ai/model/20a60c33ba954d85a669ee0f24da8e38.png?e=1778427598&token=Lk3Kb36M3K8oq2d5pU6CaYyoud2Au-APFP-ThE8B:cZUtU2t4yclXCeW0X3j0gJ8Oc58="
      }
    ]
  },
  "request_id": "8bd6b5784a1e42b79bf172607f476f56"
}

授权

​
Authorization
string
header
必填

Authorization: Bearer YOUR_API_KEY

路径参数

​
prediction_id
string
必填

创建任务时返回的任务 ID（data.task_id）。

响应

预测任务详情

​
code
string
必填

响应状态码，"0" 表示成功。

示例:

"0"

​
data
object
必填
​
request_id
string
必填

唯一请求 ID，用于排查与支持。

示例:

"8bd6b5784a1e42b79bf172607f476f56"

​
usage
object

本次预测任务的计费摘要；任务处理中时可能尚未返回。