Skip to content

事件

GET /v1/tasks/events

以 Server-Sent Events 方式推送当前任务 API Key 下所有任务的状态更新。

SSE 和 GET /v1/tasks/{id} 轮询都是受支持的状态获取方式,客户端可根据自身连接能力选择。使用轮询时,建议从 1 秒开始,指数退避到 10 秒,并加入少量随机抖动。

异步 worker 设计为单个后端实例运行。部署多个后端副本时,不保证全局、用户或 API Key 并发上限严格正确。

bash
curl -N https://api.llmapi.site/v1/tasks/events \
  -H 'Authorization: Bearer YOUR_TASK_API_KEY' \
  -H 'Accept: text/event-stream'

事件格式

text
event: task.updated
data: {"id":"8b17fd33b0e947a08cb417e81e9ea9da","status":"running","modality":"image","model":"gpt-image-2"}

心跳

text
: heartbeat

定期发送,用于保持连接。收到后直接忽略。

断线重连后,请先调用 GET /v1/tasks/{id} 确认任务最新状态,再继续处理 SSE 事件。

错误码

状态码原因
401API Key 缺失或无效。
403API Key 未启用任务 API。
503任务 API 未启用或暂时不可用。