任务生命周期详解

以下参考帮助你构建请求并解读任务在不同阶段返回的每一种响应。

通用请求参数

参数	类型	是否必填	描述
`actor`	string	是	用于指定要运行的模型 actor。
`webhook`	object	否	包含 Webhook 设置的对象。
`webhook.url`	string	否	任务完成后用于接收结果的 HTTPS 地址。
`input`	object	是	指定 prompt、模式、国家/地区等 actor 参数。

结果数据结构

参数	类型	是否必填	描述
`status`	string	是	任务状态：`pending`、`running`、`success` 或 `failed`。
`message`	string	否	当任务失败时返回的错误信息。
`task_result`	object	否	actor 对应的完整结果，字段结构请参考各模型文档。

Webhook 推送负载

如果设置了 webhook.url，Scrapeless 会以 POST 请求推送以下 JSON：

参数	类型	是否必填	描述
`task_id`	string	是	完成任务的唯一标识。
`status`	string	是	`success` 或 `failed`。
`input`	string	是	原始任务参数的 JSON 字符串。
`task_result`	object	否	与轮询接口返回相同的结果对象。

推送示例

curl --location '{webhook.url}' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "",
    "status": "",
    "input": "",
    "task_result": {}
  }'

HTTP 状态码

状态码	说明
`200`	成功获取结果。
`201`	任务创建成功。
`202`	任务仍在运行，请稍后重试。
`400`	请求无效，请根据错误信息调整参数。
`410`	任务结果已过期，默认保留 12 小时。
`429`	请求过多，请降低频率或升级额度。

入门 ChatGPT