查询外部模型任务详情

查询单个外部模型任务状态、输出和扣费信息

GET /api/open/v2/model-runs/info

查询外部模型任务详情

cURL

curl --request GET \
  --url https://www.chenyu.cn/api/open/v2/model-runs/info \
  --header 'Authorization: Bearer <token>'

200

{
  "data.run_id": "<string>",
  "data.gateway_task_id": "<string>",
  "data.status": "<string>",
  "data.settlement_status": "<string>",
  "data.frozen_amount": "<string>",
  "data.final_amount": "<string>",
  "data.released_amount": "<string>",
  "data.output": {},
  "data.error_code": "<string>",
  "data.error_message": "<string>"
}

查询外部模型任务详情

根据 run_id 查询外部模型任务详情。查询时系统会尽量同步大模型网关任务状态；任务进入终态后会完成结算或释放预扣。

请求参数

run_id · string · required

外部模型应用任务 ID

响应参数

data.run_id · string

应用任务 ID

data.gateway_task_id · string

大模型网关任务 ID

data.status · string

任务状态：created、queued、running、completed、failed、cancelled

data.settlement_status · string

结算状态：pending、settled、released

data.frozen_amount · string

预扣金额

data.final_amount · string

实际扣费金额

data.released_amount · string

已释放金额

data.output · object

模型输出。视频任务完成后通常包含 url 或 video_url

data.error_code · string

失败错误码

data.error_message · string

失败错误信息

代码示例

cURL

curl -X GET "https://www.chenyu.cn/api/open/v2/model-runs/info?run_id=modelrun_1782000000000000000_ab12cd34" \
  -H "Authorization: Bearer your_api_key"

响应示例

{
  "code": 0,
  "msg": "查询成功",
  "data": {
    "run_id": "modelrun_1782000000000000000_ab12cd34",
    "model": "doubao-seedance-2-0-260128",
    "gateway_task_id": "vid_1782000000000000000_ef56ab78",
    "status": "completed",
    "settlement_status": "settled",
    "frozen_amount": "0.60000000",
    "final_amount": "0.60000000",
    "released_amount": "0.00000000",
    "output": {
      "url": "https://example.com/video.mp4"
    }
  }
}