AI 工作流模型与变量

AI 工作流模型与变量用于在 AI Flowi Workflow 中将模型提供商和可复用值关联到组件字段。API 中心提供托管访问方式，也支持使用工作区自有的提供商密钥。支持此功能的组件字段可以按名称加载 Global Variables，无需在工作流中直接写入值。

作者：Ai Flowi · 技术审核：Janice Lee，Ai Flowi 技术支持。

发布于 · 更新于

产品： Ai Flowi 的 AI Flowi Workflow · 配置：模型访问与可复用值

API 中心的模型提供商

API 中心的目录包含 OpenAI、Anthropic、Google Gemini、DeepSeek、Groq 和 OpenRouter。必须先配置并启用提供商路由，才能运行模型调用。请检查工作区中显示的目录；仅有目录条目并不能证明提供商已启用。

Flowi AI 组件会读取 API 中心的语言模型目录，用于其 Model 选择器。模型调用使用选定的目录条目。这个选择器并不意味着所列提供商的所有模型或媒体处理能力都可用。

托管访问与自带密钥

通过 API 中心发起的托管调用使用 Flowi Tokens 支付模型费用。托管密钥归属于工作区，可以限制允许调用的 API 和令牌预算。使用托管访问时，无需在 Flowi AI 组件中放入提供商密钥。

自带密钥（BYOK）模式使用保存在工作区中的提供商密钥。API 中心会加密保存该密钥，并返回经过掩码处理的密钥信息。密钥的提供商必须与所选模型的提供商一致，且已保存的密钥必须处于启用状态。BYOK 不会针对提供商费用收取 Flowi Tokens；该费用由您的提供商账户承担。工作流运行费用仍单独计算。

请先配置模型访问，再测试组件。组件连接有效，并不代表外部模型调用已验证。请参阅工作流用量与令牌历史记录，查看已记录的费用和令牌余额。

运行前预览模型调用费用

API 中心可以在运行之前估算托管模型调用的 Flowi Token 用量。估算依据是选定的费率表和输入大小预览。配置视图会显示预计用量、预留量，以及预留后的余额。

这是基于启发式方法的费用预估，并非整个工作流的最终费用。估算不会发送模型请求，也不会收取运行费用。实际托管模型费用通过 API 中心的计费流程结算。BYOK 的提供商费用与此托管令牌预览分开计算。

配置 Flowi AI 组件

  • 将 Flowi AI 组件添加到工作流。
  • 刷新其 Model 选择器，并选择所需的 API 中心目录条目。
  • 在 API 中心检查所选模型已保存的工作区设置。已保存的设置优先于组件的 Payment 和 BYOK entry id 字段。
  • 如果已保存的设置使用 managed 模式，即使组件中指定的是 byok，调用仍使用托管访问。
  • 如果已保存的设置使用 byok，即使组件设置为 managed 模式，或指定了其他密钥，调用仍使用已保存的工作区密钥。
  • 如果该模型尚无已保存的设置，请在高级 Payment 字段中选择 managed 或 byok。选择 byok 时，填写已保存的工作区密钥的 BYOK entry id，而非提供商密钥本身。
  • 运行前，请检查实际生效的模式和已保存的密钥。BYOK 密钥必须处于启用状态、归属于该工作区，并与模型的提供商匹配。
  • 使用无害的提示词测试工作流，并检查模型回复。

组件通过 API 中心发送所选模型条目和请求使用的计费模式；如果存在已保存的工作区设置，则由这些设置决定实际生效的模式。组件不会在流程中保存提供商密钥。如果模型调用失败，请检查模型配置和错误详情。API 中心不可用、模型停用、缺少权限或 BYOK 条目不适用，都可能阻止调用。

现有模型提供商设置

模型提供商设置保存 AI Flowi Workflow 所用模型的凭据。提供商服务会列出提供商和模型，在保存时验证凭据，识别已配置的提供商，并支持启用模型和选择默认模型。对于使用该凭据系统的组件，这些设置仍然适用；它们与 API 中心的工作区 BYOK 条目彼此独立。

保存提供商凭据后，请检查目标模型是否已启用，并测试工作流。如果模型调用失败，请检查提供商配置和错误详情。

Global Variables

Global Variables（全局变量）为支持此功能的组件字段提供可复用值。启用了变量加载的字段会在组件运行前，将变量名称解析为对应的值。请先配置所需变量，再测试使用该变量的组件。

不要在共享的工作流文本和示例中放入凭据值。记录配置时，应使用变量名称或占位符，例如 YOUR_MODEL_KEY。请使用字段支持的变量加载控件，不要在工作流文本中直接写入密钥。

相关内容

LLM 选择器教程展示了文档中描述的模型路由工作流。组件目录可帮助您识别其中的模型组件和处理组件。

连接 · 第一个工作流 · 常见错误 · 了解 AI Flowi Workflow