跳转到内容

后端 web-contracts-src-backend-generation-models-dto

本页由当前 SDK 声明自动生成。 导入入口:@woohaa3/contracts。

返回接口索引

DEFAULT_GENERATION_MODELS_BASE_PATH · GenerationModelPolicyView · GenerationModelsSnapshot · GenerationModelsWriteRequest · decodeGenerationModelsWrite

DEFAULT_GENERATION_MODELS_BASE_PATH

export const DEFAULT_GENERATION_MODELS_BASE_PATH: "/api/generation-models";

GenerationModelPolicyView

单个模型策略(公开视图)。

export type GenerationModelPolicyView = {
modelKey: string;
providerId: string;
modelType: "language" | "image" | "video" | "audio" | "motion";
title?: string;
enabled: boolean;
isDefault: boolean;
order?: number;
taskTimeoutMs?: number;
interaction?: {
id: string;
version: number;
};
tombstone?: boolean;
executable: boolean;
extensionId?: string;
notice?: string;
};

成员说明:

  • executable:是否在注册表中可执行(未注册 = 不可执行,仅策略占位)。
  • extensionId:提供该模型的宿主插件 id。 由注册表投影得出:Provider 注册时声明的 extensionId。设置页用它把没有 providers.<id> 配置段的 Provider(例如「服务端接入」)的模型归到自己的卡片。 策略里残留的历史行(Provider 已卸载)没有这个字段。缺省 = 旧宿主 / 历史策略行。
  • notice:模型行上的短标签(来自 Provider 的 GenerationModelDefinition.notice)。 缺省 = 不显示;只在「需要解释这个模型为什么还在这里/来自哪」时使用。

GenerationModelsSnapshot

export type GenerationModelsSnapshot = {
revision: number;
initialized: boolean;
models: GenerationModelPolicyView[];
catalogRevision?: number;
};

关联类型:GenerationModelPolicyView

成员说明:

  • catalogRevision:当前任务目录修订。 浏览器已经周期轮询本快照;Provider 注册/可用性/模型描述版本变化时该值单调前进, 前端据此使任务目录缓存失效。缺省视为「无此信号」(旧宿主)。

GenerationModelsWriteRequest

管理写入请求(expectedRevision 并发控制)。

export type GenerationModelsWriteRequest = {
expectedRevision: number;
models: Array<{
modelKey: string;
enabled: boolean;
isDefault?: boolean;
title?: string;
order?: number;
taskTimeoutMs?: number;
interaction?: {
id: string;
version: number;
};
tombstone?: boolean;
}>;
};

decodeGenerationModelsWrite

export function decodeGenerationModelsWrite(body: unknown): DecodeResult<GenerationModelsWriteRequest>;

关联类型:DecodeResult · GenerationModelsWriteRequest