事件
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 事件。
错误码
| 状态码 | 原因 |
|---|---|
401 | API Key 缺失或无效。 |
403 | API Key 未启用任务 API。 |
503 | 任务 API 未启用或暂时不可用。 |