Retrieve a task

Read persisted task status, progress, and timestamps.

200

{
  "task_id": "task_example",
  "platform": "example",
  "status": "IN_PROGRESS",
  "progress": "50%",
  "fail_reason": "",
  "created_at": 1700000000,
  "finished_at": 0
}

GET /v1/tasks/{key}

Here key is the public task ID, unlike the plugin key in POST. The response is persisted state and does not trigger a fresh upstream query.

status is uppercase, progress is a display string, and fail_reason should not be exposed without filtering. created_at / finished_at are timestamps; the latter may be zero before completion. Missing or inaccessible tasks return 404. Tasks with discarded results can still expose status; that does not imply downloadable artifacts. See task states.

阅读中文版

Authorizations

Authorization · string · header · required

模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials

Path Parameters

key · string · required

Response

200

application/json

读取业务字段，不只检查 HTTP 状态 / Validate business fields, not only HTTP status.

task_id · string · required

status · enum<string> · required

Available options: NOT_START, SUBMITTED, QUEUED, IN_PROGRESS, SUCCESS, FAILURE, NEEDS_REVIEW, UNKNOWN

platform · string

progress · string

fail_reason · string

created_at · integer

finished_at · integer