组装分镜准备页所需的统一聚合状态。

确保给定主键对应的实体不存在。

实体已存在错误。

* 获取章节 * @returns ApiResponse_ChapterRead_ Successful Response * @throws ApiError

如果传入了实体 ID，则校验其存在性。

在阶段边界检查取消请求，并统一完成 cancelled 收尾。

按业务关联查询任意活动任务。 这里的目标只是“是否已有运行中的同类任务”，不需要挑出“最新”那一条。 因此直接从 relation link 侧过滤，再按活动状态做一次连接，并去掉排序， 避免在任务量大时触发 MySQL 的大排序与 sort buffer 压力。

将 input_dict 转为 prompt 模板所需格式，mood_tags 转为字符串。

删除镜头。

* 查询任务状态/进度（轮询） * @returns ApiResponse_TaskStatusRead_ Successful Response * @throws ApiError

获取或创建单例设置。

兼容入口：注册模型能力覆盖（按前缀匹配，大小写不敏感）。

按类别解析 Provider 实际 base_url：类别覆盖 > 通用 > 内置默认。

从 LLM 原始输出中剥离 markdown 代码块并提取 JSON 字符串。

刷新 candidate，避免响应序列化时触发异步懒加载。

让各 adapter 内 `import httpx` 后使用的 AsyncClient 走 MockTransport。

按帧类型和文本特征给图片 guidance 打分，控制最终 prompt 的收敛顺序。

异步执行。

创建供应商。

* 删除镜头 * @returns ApiResponse_NoneType_ Successful Response * @throws ApiError

将动作拍点列表转换为带阶段信息的序列。

* 镜头列表（分页） * @returns ApiResponse_PaginatedData_ShotRead__ Successful Response * @throws ApiError

归属关系校验错误。

按帧类型挑选最适合作为当前帧主拍点的动作项。

注册任务执行器；相同 key+factory 重复注册视为幂等。

必填字段错误。

解析图片最终 size。 普通图片任务优先保留显式传入的 requested_size； 视频参考帧场景则优先根据 target_ratio + resolution_profile 从 capability 推导， 以保证关键帧与目标视频画幅保持一致。

* @param {Client} client * @param {any} message * @param {Array<Transferable>} transferrables * @returns {Promise<any>}

* 更新镜头 * @returns ApiResponse_ShotRead_ Successful Response * @throws ApiError