Happy Horse · 查询任务

根据 submit 或 create 返回的平台 task_id 查询任务状态与结果。本接口为同步调用,不产生新的计费。

任务完成后,结果中可包含 video_url(及平台转存后的展示字段,与全站任务查询一致)。

<details>
<summary>基本信息</summary>

字段内容
类型应用 API
应用名称Happy Horse
应用编码happy_horse
API 名称查询任务
API 编码query
请求方式POST
请求路径/api/v1/apps/happy_horse/query
调用模式同步

</details>

鉴权

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求路径

POST /api/v1/apps/happy_horse/query

业务参数

参数类型必填说明
task_idstring是submit 成功返回的平台任务 id(task_…)

请求示例

{
    "task_id": "task_xxxxxxxxxxxxxxxx"
}

响应说明

  • status 为 processing(或等价进行中状态):任务仍在处理,可间隔轮询。
  • status 为 completed(或等价成功状态):处理完成,响应内带有可播放地址等字段(如 video_url,具体以平台任务结果与转存策略为准)。
  • error:任务失败或参数错误时返回,含 code / message。

示例(进行中,字段名以实际接口为准):

{
    "status": "processing",
    "task_id": "task_xxxxxxxxxxxxxxxx"
}

示例(成功,简化示意):

{
    "status": "completed",
    "task_id": "task_xxxxxxxxxxxxxxxx",
    "video_url": "https://example.com/output.mp4"
}

若配置了 callback_url,任务终态也会按平台统一规则推送,不必依赖轮询。

常见错误

HTTPcode含义
400invalid_request缺少或非法的 task_id
404task_not_found任务不存在或不属于当前租户
404not_found应用未上架或价格未配

说明

  • 与异步 submit 联用时,可轮询本接口;亦可使用 GET /api/v1/tasks/{task_id},与全站任务查询行为对齐(含转存后的展示 URL)。
  • 由 php think ai_developer_doc:sync_from_source --app-id=12 --only=app --force --publish 可据 ai_app_api 重生成本页在库中正文。

同类文章