跳转到主要内容
POST /v1/dreams/{id}/cancel 取消指定的 Dream。只有状态为 pendingrunning 的 Dream 可以取消。已取消的 Dream 再次调用此接口是幂等的。返回更新后的 Dream 对象

请求头

头部必选说明
AuthorizationBearer <PAT>

路径参数

参数类型说明
idstringDream ID(drm_ 前缀)

示例请求

curl -s -X POST 'https://api.qoder.com/api/v1/cloud/dreams/drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9/cancel' \
  -H "Authorization: Bearer $QODER_PAT"

示例响应

HTTP 200 OK
{
  "id": "drm_019e86b4a8f070a3b6c5d4e3f2a1b0c9",
  "type": "dream",
  "status": "canceled",
  "inputs": [{ "type": "memory_store", "memory_store_id": "memstore_019e5cdb9c3f71c3b6505eba937a40b4" }],
  "outputs": [],
  "model": { "id": "auto" },
  "instructions": "",
  "session_id": "sess_019e86b4b10578059435632bb357c5ed",
  "usage": { "input_tokens": 0, "output_tokens": 0, "cache_creation_input_tokens": 0, "cache_read_input_tokens": 0 },
  "error": null,
  "created_at": "2026-06-15T10:00:00Z",
  "ended_at": "2026-06-15T10:01:15Z",
  "archived_at": null
}

错误码

HTTPType触发条件
400invalid_request_errorDream 状态为 completedfailed(终态,无法取消)。状态为 canceled 时幂等返回 200
401authentication_error缺少或无效的认证令牌
404not_found_errorDream 不存在
完整错误信封说明详见 错误参考