尧图网站建设 
AIRI 接入 Replicate 云端图像生成从 Token 配置到源码级原理详解【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi本指南讲解如何在 AIRI 中接入 Replicate借助其云端模型完成 AI 图像生成。你将学会获取并安全保存 API Token、在设置 → 服务商 → 艺术中完成服务商配置、验证 Token 与模型可用性并通过阅读ReplicateProvider的源码实现理解默认模型、宽高比、推理步数等参数在底层是如何被解析和生效的从而在配置失败时能够快速定位问题。为什么在 AIRI 中选择 ReplicateAIRI 的“艺术创作Artistry”模块抽象了一套统一的图像生成服务商接口目前支持三类来源本地运行的 ComfyUI、Google AI Studio 的 Nano Banana以及本指南的主角 —— Replicate 云端推理服务。三者在 设置页面 中的定位分别是“本地图像生成运行器”“Google AI Studio 图像预览”和“云端模型推理服务”。如果你不想自行部署图像生成模型如 Flux 等大模型对显存和运维都有要求而是希望在 Replicate 提供的模型目录中挑选一个现成模型按需付费调用Replicate 就是最合适的选择。它把“模型选择”和“算力执行”都放在云端AIRI 侧只需保存一个 API Token 即可发起生成任务。第一步获取 Replicate API Token登录 Replicate 账户进入 API Tokens 页面创建一个新的 API Token。Token 通常以r8_开头这与 AIRI 设置页中 API 密钥输入框的占位符提示一致见 settings.yaml。确认账户已配置可用的计费方式或额度。Replicate 按推理用量计费Token 本身有效不代表账户有可用额度。复制 Token 并妥善保存。API Token 安全警告不要将 Token 提交到仓库、放入截图或发送给他人。Token 一旦泄露请立即在 Replicate 控制台撤销该 Token 并重新创建。在 AIRI 的设置界面中API 密钥输入框被实现为typepassword的密码输入框见 replicate.vue但应用外的泄露风险仍需你自己防范。第二步在 AIRI 中完成配置配置入口为设置 → 服务商 → 艺术 → Replicate。页面源码 replicate.vue 展示了完整的表单结构共四个配置项配置项说明AIRI 默认值输入控件API 密钥API KeyReplicate API Token以r8_开头空密码输入框默认模型Default Model角色卡未指定模型时的备用所有者/模型标识black-forest-labs/flux-schnell文本输入框宽高比Aspect Ratio默认图像宽高比如16:9、1:1、9:1616:9文本输入框推理步数Inference Steps扩散采样步数越低生成越快、越高质量越好4滑块范围1 ~ 50步长 1配置项的默认值来自哪里以上默认值并非写死在单个页面上而是有三处相互印证的来源Electron 主进程配置 Schemaartistry.ts 中通过 valibot 定义了artistryConfigSchema其中replicateApiKey默认空字符串、replicateDefaultModel默认black-forest-labs/flux-schnell、replicateAspectRatio默认16:9、replicateInferenceSteps默认数字4。该配置最终持久化到主进程的artistry/options.json。渲染进程 Pinia Storeartistry.ts 中通过useLocalStorageManualReset持久化四个 Replicate 字段对应的 localStorage 键名分别为artistry-replicate-api-key、artistry-replicate-default-model、artistry-replicate-aspect-ratio、artistry-replicate-inference-steps默认值与主进程 Schema 完全一致。提供方实现类replicate.ts 中ReplicateProvider的私有字段初始化同样复刻了这三组默认值。三处默认值保持一致意味着你在设置页看到的占位提示、空配置时的回退行为以及实际发起请求时的取值是统一的。配置项在源码中如何生效在设置页修改这些字段后它们会经由ReplicateProvider.initialize(config)被读取replicate.ts读取config.replicateApiKey非空时用new Replicate({ auth: this.apiKey })实例化官方 SDK 客户端为空则置空并置replicate null后续生成会直接抛出 “Replicate provider is not configured. Missing API Key.” 错误。依次读取replicateDefaultModel、replicateAspectRatio、replicateInferenceSteps分别覆盖默认模型、默认宽高比和默认推理步数。而“是否算已配置”的判定在 artistry.ts 的configured计算属性中当活动服务商为replicate时只要replicateApiKey非空即视为已配置这正对应了官方文档中“成功返回图片即表示 Token、模型 ID 和账户额度可用”的验证逻辑。第三步验证配置完成设置后按以下步骤验证打开设置 → 艺术在图像生成来源中选中Replicate。使用一条不含敏感信息的提示词发起一次图片生成例如“a cute cartoon cat on a sunny beach”。若成功返回图片说明 Token、模型 ID 和账户额度三项均可用。如果生成入口提示“未配置”请回到设置 → 服务商 → 艺术 → Replicate确认 API 密钥已填写——根据configured计算属性Replicate 服务商是否可用的唯一判定条件就是 API 密钥非空。底层调用链一次 Replicate 生成请求是如何完成的理解配置参数如何抵达云端能帮你更好地排查问题。AIRI 中所有图像服务商都必须实现 ArtistryProvider 接口ReplicateProvider即该接口的云端实现replicate.tsid replicate显示名为 “Replicate.ai (Cloud)”。其generate()方法replicate.ts的处理流程如下模型解析依次取request.model→request.extra.model→ 全局默认模型即你在设置页填写的默认模型 ID并断言为所有者/模型形式的字符串。默认参数装配生成一组带默认值的输入参数go_fast: true、aspect_ratio默认取设置值、output_format: png、output_quality: 80、num_inference_steps默认取设置值即 4。同时把主提示词注入为prompt字段。合并 JSON 参数覆盖如果角色卡携带了providerOptions即“JSON 参数”文本框内容会将其逐项合并覆盖默认参数其中prompt字段被刻意剔除避免覆盖由桥接层注入的带前缀版本。占位符替换递归遍历参数对象将字符串中的{{IMAGE}}替换为输入图像自动补全data:image/jpeg;base64,前缀、{{PROMPT}}替换为截断后的提示词。这在图生图img2img与模型微调场景中非常实用。异步执行由于replicate.run()会阻塞直到生成完成而接口要求generate()立即返回任务句柄实现中会立即返回{ jobId, providerJobId }把真正的生成放到后台runGeneration()中执行。runGeneration()replicate.ts负责调用replicate.run(model, { input })并兼容 SDK 的三种返回形态带url()方法的 FileUpload 对象、带字符串url属性的对象、以及直接返回 URL 字符串从中提取图片地址后通过状态回调把succeededimageUrl推送回界面。任务失败时则返回failed状态并附带错误信息。提示词截断机制为了防止超长提示词导致云端请求失败truncatePrompt()replicate.ts会将提示词截断至380 字符超出部分以...结尾并在日志中记录截断行为。这解释了“生成结果不符合预期”时的一个常见原因如果提示词超过 380 字符后半段会被截掉与模型参数无关。排查指南官方文档的排查思路对应着源码中的具体失败分支可按下表逐项核对现象可能原因检查与处置认证失败401 类错误Token 粘贴不完整或已失效核对 Token 是否以r8_开头且无多余空格如已泄露则撤销重建请求被拒绝或生成失败账户额度不足 / 模型无访问权限 / 模型 ID 写错到 Replicate 控制台确认计费与额度在模型页面复制精确的所有者/模型ID查看 AIRI 日志中[Replicate] Generation Failed后的错误摘要提示“未配置”API 密钥为空configured判定要求replicateApiKey非空回设置页补填生成结果不符合预期模型不支持当前比例/参数或提示词被截断先确认所选模型支持的宽高比与参数范围降低推理步数滑块最小 1或更换模型提示词控制在 380 字符内模型 ID 的取值要点设置页的“默认模型”是一个备用模型 ID当角色卡没有显式指定模型时才生效这正是 i18n 中“角色卡未指定模型时使用的备用所有者/模型字符串”的含义见 settings.yaml。请务必以 Replicate 模型页面显示的精确 ID 为准格式为所有者/模型名例如black-forest-labs/flux-schnell。角色卡级联单卡覆盖全局设置值得补充的是AIRI 的“艺术”设置存在全局偏好与角色卡覆盖两层结构。artistry.ts 将全局服务商、全局模型、全局提示词前缀和全局参数持久化而角色卡airi-card可通过providerOptions携带自己的参数覆盖接口定义见 base.ts其中注释给出了 Replicate 的示例{ go_fast: true, megapixels: 1, aspect_ratio: 16:9, ... }。这意味着同一个 Replicate Token 可以为不同角色卡配置不同的模型、宽高比与推理步数全局默认值只作为兜底。当角色卡没有覆盖时resetToGlobal()会把活动设置同步为全局偏好。结语Replicate 是 AIRI 艺术创作模块中最轻量的云端图像生成方案只需要一个r8_开头的 API Token配合默认模型、宽高比和推理步数三个参数即可完成接入。读懂 ReplicateProvider 的实现后你会发现设置页上的每个字段都与底层请求参数一一对应replicateDefaultModel→model、replicateAspectRatio→input.aspect_ratio、replicateInferenceSteps→input.num_inference_steps排查问题时只需沿着这条链路逐段核对即可。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AIRI 接入 Replicate 云端图像生成：从 Token 配置到源码级原理详解
AIRI 接入 Replicate 云端图像生成从 Token 配置到源码级原理详解【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi本指南讲解如何在 AIRI 中接入 Replicate借助其云端模型完成 AI 图像生成。你将学会获取并安全保存 API Token、在设置 → 服务商 → 艺术中完成服务商配置、验证 Token 与模型可用性并通过阅读ReplicateProvider的源码实现理解默认模型、宽高比、推理步数等参数在底层是如何被解析和生效的从而在配置失败时能够快速定位问题。为什么在 AIRI 中选择 ReplicateAIRI 的“艺术创作Artistry”模块抽象了一套统一的图像生成服务商接口目前支持三类来源本地运行的 ComfyUI、Google AI Studio 的 Nano Banana以及本指南的主角 —— Replicate 云端推理服务。三者在 设置页面 中的定位分别是“本地图像生成运行器”“Google AI Studio 图像预览”和“云端模型推理服务”。如果你不想自行部署图像生成模型如 Flux 等大模型对显存和运维都有要求而是希望在 Replicate 提供的模型目录中挑选一个现成模型按需付费调用Replicate 就是最合适的选择。它把“模型选择”和“算力执行”都放在云端AIRI 侧只需保存一个 API Token 即可发起生成任务。第一步获取 Replicate API Token登录 Replicate 账户进入 API Tokens 页面创建一个新的 API Token。Token 通常以r8_开头这与 AIRI 设置页中 API 密钥输入框的占位符提示一致见 settings.yaml。确认账户已配置可用的计费方式或额度。Replicate 按推理用量计费Token 本身有效不代表账户有可用额度。复制 Token 并妥善保存。API Token 安全警告不要将 Token 提交到仓库、放入截图或发送给他人。Token 一旦泄露请立即在 Replicate 控制台撤销该 Token 并重新创建。在 AIRI 的设置界面中API 密钥输入框被实现为typepassword的密码输入框见 replicate.vue但应用外的泄露风险仍需你自己防范。第二步在 AIRI 中完成配置配置入口为设置 → 服务商 → 艺术 → Replicate。页面源码 replicate.vue 展示了完整的表单结构共四个配置项配置项说明AIRI 默认值输入控件API 密钥API KeyReplicate API Token以r8_开头空密码输入框默认模型Default Model角色卡未指定模型时的备用所有者/模型标识black-forest-labs/flux-schnell文本输入框宽高比Aspect Ratio默认图像宽高比如16:9、1:1、9:1616:9文本输入框推理步数Inference Steps扩散采样步数越低生成越快、越高质量越好4滑块范围1 ~ 50步长 1配置项的默认值来自哪里以上默认值并非写死在单个页面上而是有三处相互印证的来源Electron 主进程配置 Schemaartistry.ts 中通过 valibot 定义了artistryConfigSchema其中replicateApiKey默认空字符串、replicateDefaultModel默认black-forest-labs/flux-schnell、replicateAspectRatio默认16:9、replicateInferenceSteps默认数字4。该配置最终持久化到主进程的artistry/options.json。渲染进程 Pinia Storeartistry.ts 中通过useLocalStorageManualReset持久化四个 Replicate 字段对应的 localStorage 键名分别为artistry-replicate-api-key、artistry-replicate-default-model、artistry-replicate-aspect-ratio、artistry-replicate-inference-steps默认值与主进程 Schema 完全一致。提供方实现类replicate.ts 中ReplicateProvider的私有字段初始化同样复刻了这三组默认值。三处默认值保持一致意味着你在设置页看到的占位提示、空配置时的回退行为以及实际发起请求时的取值是统一的。配置项在源码中如何生效在设置页修改这些字段后它们会经由ReplicateProvider.initialize(config)被读取replicate.ts读取config.replicateApiKey非空时用new Replicate({ auth: this.apiKey })实例化官方 SDK 客户端为空则置空并置replicate null后续生成会直接抛出 “Replicate provider is not configured. Missing API Key.” 错误。依次读取replicateDefaultModel、replicateAspectRatio、replicateInferenceSteps分别覆盖默认模型、默认宽高比和默认推理步数。而“是否算已配置”的判定在 artistry.ts 的configured计算属性中当活动服务商为replicate时只要replicateApiKey非空即视为已配置这正对应了官方文档中“成功返回图片即表示 Token、模型 ID 和账户额度可用”的验证逻辑。第三步验证配置完成设置后按以下步骤验证打开设置 → 艺术在图像生成来源中选中Replicate。使用一条不含敏感信息的提示词发起一次图片生成例如“a cute cartoon cat on a sunny beach”。若成功返回图片说明 Token、模型 ID 和账户额度三项均可用。如果生成入口提示“未配置”请回到设置 → 服务商 → 艺术 → Replicate确认 API 密钥已填写——根据configured计算属性Replicate 服务商是否可用的唯一判定条件就是 API 密钥非空。底层调用链一次 Replicate 生成请求是如何完成的理解配置参数如何抵达云端能帮你更好地排查问题。AIRI 中所有图像服务商都必须实现 ArtistryProvider 接口ReplicateProvider即该接口的云端实现replicate.tsid replicate显示名为 “Replicate.ai (Cloud)”。其generate()方法replicate.ts的处理流程如下模型解析依次取request.model→request.extra.model→ 全局默认模型即你在设置页填写的默认模型 ID并断言为所有者/模型形式的字符串。默认参数装配生成一组带默认值的输入参数go_fast: true、aspect_ratio默认取设置值、output_format: png、output_quality: 80、num_inference_steps默认取设置值即 4。同时把主提示词注入为prompt字段。合并 JSON 参数覆盖如果角色卡携带了providerOptions即“JSON 参数”文本框内容会将其逐项合并覆盖默认参数其中prompt字段被刻意剔除避免覆盖由桥接层注入的带前缀版本。占位符替换递归遍历参数对象将字符串中的{{IMAGE}}替换为输入图像自动补全data:image/jpeg;base64,前缀、{{PROMPT}}替换为截断后的提示词。这在图生图img2img与模型微调场景中非常实用。异步执行由于replicate.run()会阻塞直到生成完成而接口要求generate()立即返回任务句柄实现中会立即返回{ jobId, providerJobId }把真正的生成放到后台runGeneration()中执行。runGeneration()replicate.ts负责调用replicate.run(model, { input })并兼容 SDK 的三种返回形态带url()方法的 FileUpload 对象、带字符串url属性的对象、以及直接返回 URL 字符串从中提取图片地址后通过状态回调把succeededimageUrl推送回界面。任务失败时则返回failed状态并附带错误信息。提示词截断机制为了防止超长提示词导致云端请求失败truncatePrompt()replicate.ts会将提示词截断至380 字符超出部分以...结尾并在日志中记录截断行为。这解释了“生成结果不符合预期”时的一个常见原因如果提示词超过 380 字符后半段会被截掉与模型参数无关。排查指南官方文档的排查思路对应着源码中的具体失败分支可按下表逐项核对现象可能原因检查与处置认证失败401 类错误Token 粘贴不完整或已失效核对 Token 是否以r8_开头且无多余空格如已泄露则撤销重建请求被拒绝或生成失败账户额度不足 / 模型无访问权限 / 模型 ID 写错到 Replicate 控制台确认计费与额度在模型页面复制精确的所有者/模型ID查看 AIRI 日志中[Replicate] Generation Failed后的错误摘要提示“未配置”API 密钥为空configured判定要求replicateApiKey非空回设置页补填生成结果不符合预期模型不支持当前比例/参数或提示词被截断先确认所选模型支持的宽高比与参数范围降低推理步数滑块最小 1或更换模型提示词控制在 380 字符内模型 ID 的取值要点设置页的“默认模型”是一个备用模型 ID当角色卡没有显式指定模型时才生效这正是 i18n 中“角色卡未指定模型时使用的备用所有者/模型字符串”的含义见 settings.yaml。请务必以 Replicate 模型页面显示的精确 ID 为准格式为所有者/模型名例如black-forest-labs/flux-schnell。角色卡级联单卡覆盖全局设置值得补充的是AIRI 的“艺术”设置存在全局偏好与角色卡覆盖两层结构。artistry.ts 将全局服务商、全局模型、全局提示词前缀和全局参数持久化而角色卡airi-card可通过providerOptions携带自己的参数覆盖接口定义见 base.ts其中注释给出了 Replicate 的示例{ go_fast: true, megapixels: 1, aspect_ratio: 16:9, ... }。这意味着同一个 Replicate Token 可以为不同角色卡配置不同的模型、宽高比与推理步数全局默认值只作为兜底。当角色卡没有覆盖时resetToGlobal()会把活动设置同步为全局偏好。结语Replicate 是 AIRI 艺术创作模块中最轻量的云端图像生成方案只需要一个r8_开头的 API Token配合默认模型、宽高比和推理步数三个参数即可完成接入。读懂 ReplicateProvider 的实现后你会发现设置页上的每个字段都与底层请求参数一一对应replicateDefaultModel→model、replicateAspectRatio→input.aspect_ratio、replicateInferenceSteps→input.num_inference_steps排查问题时只需沿着这条链路逐段核对即可。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考