CutAI API 的所有资源都绑定到用户。API Key 也绑定到创建它的用户。

基本规则

  • API Key 只能访问所属用户自己的任务、job 和资产
  • 请求体里的 userId 会被忽略;服务端始终使用鉴权上下文里的用户 ID
  • 图生图的 inputAssetIds 必须属于当前用户
  • taskId 查询时必须属于当前用户,否则返回 TASK_NOT_FOUND

常见响应

为避免泄露其他用户资源是否存在,跨用户资源通常返回 404:
场景HTTPCode
查询别人的任务404TASK_NOT_FOUND
使用不属于当前用户的参考资产400INVALID_REFERENCE_ASSET