mirror of
https://git.openapi.site/https://github.com/desirecore/config-center.git
synced 2026-09-07 00:33:38 +08:00
228 lines
11 KiB
JSON
228 lines
11 KiB
JSON
{
|
||
"$schema": "http://json-schema.org/draft-07/schema#",
|
||
"$id": "https://desirecore.net/schemas/config-center/model-spec.schema.json",
|
||
"title": "ModelSpecFile",
|
||
"description": "模型规格库（compute/model-specs/*.json）数据契约。\n\n用途：维护模型的「内在参数」（上下文窗口、最大输出、能力标签、serviceType、默认采样参数等），这些参数与「从哪家 provider、什么价格调用」无关，是模型的客观物理属性。\n\n接入路径（首期仅 cloud）：登录后从 NewAPI pricing 拉到的模型，只承担「可用模型清单 + 价签」职责；客户端按 modelName 用通用匹配机制查询本规格库，补全 tags 无法表达的结构化参数（maxOutputTokens / defaultTemperature 等）。\n\n与 provider.schema.json 的区别：provider 文件是「完整 provider 接入定义」，本文件是「跨 provider 共享的模型参数字典」。本文件是老客户端不会读取的新文件，因此 schema 可以更宽松（允许 null），且不破坏已发布客户端兼容契约。\n\n严禁写入价格字段（inputPrice/outputPrice/cache 等）——价签真相源永远是 NewAPI pricing。",
|
||
"type": "object",
|
||
"required": ["specs"],
|
||
"properties": {
|
||
"description": {
|
||
"type": "string",
|
||
"description": "文件说明（如所属厂商、收录范围）"
|
||
},
|
||
"specs": {
|
||
"type": "array",
|
||
"description": "模型规格条目列表",
|
||
"items": { "$ref": "#/definitions/modelSpec" }
|
||
}
|
||
},
|
||
"additionalProperties": false,
|
||
"definitions": {
|
||
"modelOrigin": {
|
||
"type": "object",
|
||
"required": ["vendor", "canonicalModelId"],
|
||
"properties": {
|
||
"vendor": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
|
||
"description": "规范化原厂商 ID，如 xiaomi、openai、alibaba、minimax；不得填写当前算力 Provider ID。"
|
||
},
|
||
"canonicalModelId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "原厂模型的稳定识别 ID，用于适配器匹配、诊断和日志；不替代实际路由使用的 modelName/apiModelId。"
|
||
},
|
||
"family": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "跨小版本稳定的模型家族，如 mimo-asr；同一协议下的后续模型版本可复用该家族语义。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"speechVoice": {
|
||
"type": "object",
|
||
"required": ["id", "label"],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "传给上游语音接口的稳定音色 ID。"
|
||
},
|
||
"label": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "面向用户展示的音色名称。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"speechModelProfile": {
|
||
"type": "object",
|
||
"required": ["protocol", "protocolVersion", "modes"],
|
||
"properties": {
|
||
"protocol": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
|
||
"description": "稳定语音协议族，如 xiaomi-mimo-chat-asr；模型常规迭代不得改变此值。"
|
||
},
|
||
"protocolVersion": {
|
||
"type": "string",
|
||
"pattern": "^[1-9][0-9]*$",
|
||
"description": "协议不兼容版本号；只有请求、认证、响应或流式状态机发生不兼容变化时才递增。"
|
||
},
|
||
"modes": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": { "type": "string", "enum": ["batch", "streaming"] },
|
||
"description": "模型协议支持的调用模式：batch（整段）和/或 streaming（流式）。"
|
||
},
|
||
"inputFormats": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": { "type": "string", "minLength": 1 },
|
||
"description": "ASR 上游接受的音频格式，如 wav、mp3、webm；格式名使用适配器可识别的规范值。"
|
||
},
|
||
"outputFormats": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": { "type": "string", "minLength": 1 },
|
||
"description": "TTS 上游可返回的音频格式，如 pcm16le、wav、mp3；运行时需与适配器和播放器能力求交集。"
|
||
},
|
||
"sampleRates": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": { "type": "integer", "minimum": 1 },
|
||
"description": "支持的采样率（Hz）；运行时不得假设固定采样率，需完成能力协商。"
|
||
},
|
||
"defaultVoice": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "TTS 推荐默认音色 ID；声明 voices 时必须能在 voices 中找到同 ID 条目。"
|
||
},
|
||
"voices": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"items": { "$ref": "#/definitions/speechVoice" },
|
||
"description": "TTS 可选音色列表，统一为稳定 id 与用户可读 label。"
|
||
},
|
||
"languageHints": {
|
||
"type": "boolean",
|
||
"description": "ASR 协议是否接受语言提示参数；不是模型支持语言范围清单。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"modelSpec": {
|
||
"type": "object",
|
||
"required": ["id", "spec"],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"description": "模型标准标识符，通常等于上游 model_name 原样（保留大小写与点号，如 claude-sonnet-4-6、MiniMax-M2.7）。同时作为精确匹配键；匹配时大小写/分隔符不敏感（由匹配器归一化）。",
|
||
"minLength": 1
|
||
},
|
||
"displayName": {
|
||
"type": "string",
|
||
"description": "模型友好显示名（如 Claude Sonnet 4.6）。命中后可覆盖 NewAPI 返回的原始 model_name，优化 UI 展示。"
|
||
},
|
||
"family": {
|
||
"type": "string",
|
||
"description": "模型家族标识（如 claude-sonnet、gpt-5、gemini-2.5）。当精确/别名/pattern 匹配均失败时，按最长 family 前缀兜底匹配，返回保守参数并标记 inferred。"
|
||
},
|
||
"match": {
|
||
"type": "object",
|
||
"description": "通用匹配规则。匹配器会先做归一化（小写、去 vendor 前缀如 anthropic/、去网关装饰、统一分隔符、去日期戳与波动后缀），再分层匹配：exact > 归一化 exact > 去日期戳后 exact > pattern（取最长） > family 兜底。",
|
||
"properties": {
|
||
"exact": {
|
||
"type": "array",
|
||
"description": "精确别名列表（除 id 外的已知精确名，含网关可能使用的全名）。归一化后比对。",
|
||
"items": { "type": "string", "minLength": 1 }
|
||
},
|
||
"patterns": {
|
||
"type": "array",
|
||
"description": "glob 模式列表（如 claude-sonnet-4-6*）。仅在 exact + 去日期戳仍无法覆盖变体时使用；避免对存在子型号的父模型（如 gpt-4o 之于 gpt-4o-mini）使用宽泛通配，以防误吞。多命中取最长 pattern。",
|
||
"items": { "type": "string", "minLength": 1 }
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"spec": {
|
||
"type": "object",
|
||
"description": "模型内在参数（不含任何价格字段）",
|
||
"properties": {
|
||
"contextWindow": {
|
||
"type": "number",
|
||
"description": "上下文窗口大小（token 数）。下游用于上下文裁剪阈值计算。",
|
||
"minimum": 0
|
||
},
|
||
"maxOutputTokens": {
|
||
"type": "number",
|
||
"description": "单次请求最大输出 token 数。tags 字符串无法表达，是本规格库相对 NewAPI tags 的核心补充。",
|
||
"minimum": 0
|
||
},
|
||
"capabilities": {
|
||
"type": "array",
|
||
"description": "模型能力标签：chat、vision、tool_use、code、reasoning 等。与 NewAPI tags 解析结果取并集。",
|
||
"items": { "type": "string" }
|
||
},
|
||
"serviceType": {
|
||
"type": ["string", "array"],
|
||
"items": { "type": "string" },
|
||
"description": "服务类型，单个字符串或数组：chat、reasoning、fast、vision、embedding、image_gen、tts、asr 等。命中时优先于 tags 解析。"
|
||
},
|
||
"defaultTemperature": {
|
||
"type": ["number", "null"],
|
||
"description": "推荐默认温度（0-2）。null 表示模型不支持温度调节（如 reasoning 模型），调用方应跳过该参数。本文件为新文件，老客户端不读，故允许 null。",
|
||
"minimum": 0,
|
||
"maximum": 2
|
||
},
|
||
"defaultTopP": {
|
||
"type": ["number", "null"],
|
||
"description": "推荐默认 Top-P（0-1）。null 表示不支持调节。",
|
||
"minimum": 0,
|
||
"maximum": 1
|
||
},
|
||
"supportsReasoning": {
|
||
"type": "boolean",
|
||
"description": "是否为推理模型。用于运行时决定是否启用 reasoning 相关处理。"
|
||
},
|
||
"description": {
|
||
"type": "string",
|
||
"description": "模型简要描述（一句话特点与适用场景）。命中后可覆盖 NewAPI 原值。"
|
||
},
|
||
"extra": {
|
||
"type": "object",
|
||
"description": "模型内在开放扩展：modelOrigin 描述真实原厂身份，speech 描述可跨小版本复用的语音协议；不含价格，也不得声明 Provider/接入面的 reasoning effort 能力。",
|
||
"not": { "required": ["reasoning"] },
|
||
"properties": {
|
||
"modelOrigin": { "$ref": "#/definitions/modelOrigin" },
|
||
"speech": { "$ref": "#/definitions/speechModelProfile" }
|
||
},
|
||
"additionalProperties": true
|
||
},
|
||
"releasedAt": {
|
||
"type": "string",
|
||
"description": "厂商发布年月（YYYY-MM 或 YYYY-MM-DD），辅助人工判断模型新旧。无客户端行为，仅供维护者参考何时清理该条规格。",
|
||
"pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
|
||
},
|
||
"retiredAt": {
|
||
"type": "string",
|
||
"description": "厂商宣布停止访问的日期（YYYY-MM-DD），辅助人工批量删除已退役的规格条目。无客户端行为，仅作数据清理依据。",
|
||
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
}
|
||
}
|