> ## Documentation Index > Fetch the complete documentation index at: https://docs.dify.ai/llms.txt > Use this file to discover all available pages before exploring further. # 模型规范 > Dify 模型插件相关实体的参考，包括 Provider、AIModelEntity、模型类型、配置方法、参数规则和凭据模式 > 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/develop-plugin/features-and-specs/plugin-types/model-designing-rules)。模型插件通过两个实体描述自身：[Provider](#provider) 负责认证并列出所支持的模型，每个模型对应一个 [AIModelEntity](#aimodelentity)，用于声明其类型、特性和参数。下文所有实体均为 `dify_plugin.entities.model` 模块中的 `Pydantic BaseModel` 子类。 ## 快速决策用户粘贴 API key 即可获得你的完整模型列表。设置 `configurate_methods: [predefined-model]`，并在 YAML 中定义每个模型的 AIModelEntity。用户自行配置模型名称和 base URL（OpenAI 兼容端点、自定义部署）。设置 `configurate_methods: [customizable-model]`，详见 [自定义模型](/zh/develop-plugin/features-and-specs/advanced-development/customizable-model)。内置目录加上用户添加的自定义模型。同时使用两种 `configurate_methods` 取值。完整的端到端示例，详见 [创建新模型供应商](/zh/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider)。 ## Provider 供应商标识符，例如 `openai`。供应商显示名称（i18n）。支持 `en_US`（英文）和 `zh_Hans`（中文）。中文标签。若未设置，回退使用 `en_US`。英文标签供应商描述（i18n）。中文描述。英文描述。供应商小图标，存储在供应商实现目录下的 `_assets` 目录中。中文图标。英文图标。供应商大图标，存储在供应商实现目录下的 `_assets` 目录中。中文图标。英文图标。背景颜色值，例如 `#FFFFFF`。若为空，则使用前端默认颜色。帮助信息。帮助标题（i18n）。中文标题。英文标题。帮助链接（i18n）。中文链接。英文链接。支持的模型类型。配置方法。供应商凭据规范。模型凭据规范。 ## AIModelEntity 模型标识符，例如 `gpt-3.5-turbo`。模型显示名称（i18n）。支持 `en_US`（英文）和 `zh_Hans`（中文）。中文标签。英文标签。模型类型。支持的特性。模型属性。模式（模型类型 `llm`）。上下文大小（模型类型 `llm` 和 `text-embedding`）。最大分段数（模型类型 `text-embedding` 和 `moderation`）。最大文件上传大小，单位为 MB（模型类型 `speech2text`）。支持的文件扩展名，例如 `mp3,mp4`（模型类型 `speech2text`）。默认语音，取值为 `alloy`、`echo`、`fable`、`onyx`、`nova`、`shimmer` 之一（模型类型 `tts`）。可用语音（模型类型 `tts`）。语音模型。语音模型显示名称。语音模型支持的语言。单次转换的字数限制，默认按段落分割（模型类型 `tts`）。支持的音频文件扩展名，例如 `mp3,wav`（模型类型 `tts`）。文字转音频转换的并发任务数（模型类型 `tts`）。每个分段的最大字符数（模型类型 `moderation`）。模型调用参数的规则。价格信息。模型是否已弃用。已弃用的模型不再出现在模型列表中，但已有配置仍可继续使用。默认为 `False`。 ## ModelType 文本生成模型。文本嵌入模型。重排序模型。语音转文字。文字转语音。内容审核。 ## ConfigurateMethod 预定义模型。用户只需配置一次统一的供应商凭据，即可使用该供应商下的所有预定义模型。自定义模型。用户需要为每个模型添加凭据配置。从远程获取。与 `predefined-model` 类似，只需统一的供应商凭据，但模型列表是使用这些凭据从供应商获取的。 ## ModelFeature Agent 推理。通常 70B 以上的模型具备思维链能力。视觉（图像理解）。工具调用。多工具调用。流式工具调用。 ## FetchFrom 预定义模型。远程模型。 ## LLMMode 文本续写。对话。 ## ParameterRule 模型调用中使用的实际参数名称。使用的模板。预定义了 5 个参数模板： * `temperature` * `top_p` * `frequency_penalty` * `presence_penalty` * `max_tokens` 在 `use_template` 中设置上述名称之一，即可继承 `entities.defaults.PARAMETER_RULE_TEMPLATE` 中的默认配置，此时只需提供 `name` 和 `use_template`。你设置的任何额外参数都会覆盖模板默认值。参见 `openai/llm/gpt-3.5-turbo.yaml` 以及 [创建新模型供应商](/zh/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider) 中的示例。标签（i18n）。中文标签。英文标签。参数类型。整数。浮点数。字符串。布尔值。帮助信息（i18n）。中文帮助文本。英文帮助文本。参数是否必填。默认为 `False`。默认值。最小值。仅适用于数值类型。最大值。仅适用于数值类型。保留的小数位数。仅适用于数值类型。下拉选项值。仅当 `type` 为 `string` 时适用。若未设置或为 null，则不限制取值。 ## PriceConfig 输入（提示词）单价。输出（返回内容）单价。价格单位。例如，若按每 1M token 计价，则单价对应的单位 token 数为 `0.000001`。货币单位。 ## ProviderCredentialSchema 凭据表单规范。 ## ModelCredentialSchema 模型标识符。默认变量名为 `model`。模型表单项的显示名称。英文。中文。模型表单项的占位符文本。英文。中文。凭据表单规范。 ## CredentialFormSchema 表单项变量名。表单项标签。英文。中文。表单项类型。表单项是否必填。默认值。下拉内容。仅适用于 `select` 和 `radio` 类型。表单项占位符。仅适用于 `text-input` 类型。英文。中文。最大输入长度。仅适用于 `text-input` 类型。`0` 表示无限制。仅当其他表单项的值满足给定条件时才显示此项。为空表示始终显示。 ### FormType 文本输入组件。密码输入组件。单选下拉框。单选按钮组件。开关组件。仅支持 `true` 和 `false`。 ### FormOption 标签。英文。中文。下拉选项值。仅当其他表单项的值满足给定条件时才显示此选项。为空表示始终显示。 ### FormShowOnObject 其他表单项的变量名。其他表单项的变量值。 ## 相关资源 * [模型架构详解](/zh/develop-plugin/features-and-specs/plugin-types/model-schema)：模型插件的架构规范 * [快速集成新模型](/zh/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider)：应用这些规则添加新模型 * [通用规范](/zh/develop-plugin/features-and-specs/plugin-types/general-specifications)：插件清单文件的配置 * [创建新模型供应商](/zh/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider)：开发全新的模型供应商插件