根据 ID 查询一次 Dream 的状态、结果和用量。
GET /api/v1/forward/dreams/{id}
创建 Dream 后,可以轮询此接口,直到 status 进入 completed、failed 或 canceled 终态。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或管理员 SAT>。 |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
id | string | 是 | Dream ID,前缀为 drm_。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 返回值 | object | 当前状态的 Dream 对象。 |
错误
| HTTP | Type | 触发条件 |
|---|---|---|
400 | invalid_request_error | id 不是有效的 Dream ID;error.code 为 invalid_dream_id。 |
401 | authentication_error | 认证信息缺失、无效或已过期。 |
403 | permission_error | 当前令牌不能查询 Dream;Identity SAT 不支持此接口。 |
404 | not_found_error | Dream 不存在或当前调用方不可见;error.code 为 dream_not_found。 |
500/502/503 | api_error | 服务或内部依赖暂时不可用。 |

