账户操作与计费查询
按业务职责归类的既有接口契约
更新时间:2026年09月08日 13时20分03秒(UTC+8)
本次仅迁移文档,不改变接口行为。原有“候选”标识保留,表示发布状态尚需逐项核验,不代表本次已上线该能力。
当前账户操作核验(开发候选)
GET /api/account/operation?operationId=... 要求网站登录,操作标识为 1–128 位字母、数字、_ . : -。只查询当前登录用户作为账单拥有者的记录,不接受客户端指定 userId 或画布拥有者。不存在与其他账户记录统一返回 404 operation_not_found;非法标识 400 invalid_operation_id、读取故障 503 operation_read_failed,全部响应 no-store。
成功返回 { ok: true, operation }:operationId、billing(预留状态、预留积分、实际结算积分、更新时间)、provider(服务端绑定 namespace/taskId、已存结果状态及记录时间)、source: "server_database"、replayAllowed: false、qualityVerified: false。积分使用十进制字符串,缺少结算记录返回 null 而非零。结果状态仅白名单字符串;不返回提示词、媒体 URL、原始供应商结果或数据库内部错误。
这是已有数据库记录的只读快照,不调用供应商、不触发重新计费或生成;结果可能尚未更新,settled 不代表视觉质量通过。操作 ID 必须使用实际服务端计费 ID,不能用推测的请求根 ID 替代。任务面板已按需接入并提示标识冲突;共享画布协作者的账单查看及可信客户端报告关联验证仍待补齐;此接口不是 Partner API。