@framers/agentos-ext-image-generation

中文文档
2.1.3发布于 2026/11/02Apache-2.0TypeScriptCommonJS零依赖构建来源已验证近 30 天下载 2.2万

AgentOS的图像生成扩展——OpenAI,OpenRouter,稳定AI,和复制

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. 配置
  4. 工具
  5. generate_image
  6. 页:1
  7. 释放
  8. 许可证

图像生成

这个包通过AgentOS SDK,通过OpenAI,OpenRouter,稳定AI或复制,给一个代理一个文本到图像的工具.

安装

npm install @framers/agentos-ext-image-generation

同伴依赖 : @framers/agentos 有范围 >=0.10.40。 。 。 .

使用量

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-image-generation',
        options: {
          openaiApiKey: process.env.OPENAI_API_KEY,
          openrouterApiKey: process.env.OPENROUTER_API_KEY,
          stabilityApiKey: process.env.STABILITY_API_KEY,
          replicateApiToken: process.env.REPLICATE_API_TOKEN,
          imageDir: process.env.AGENTOS_IMAGE_DIR,
        },
      },
    ],
  },
});

配置

选项秘密编号环境变量需求默认
openaiApiKeyopenai.apiKeyOPENAI_API_KEY对选中的 OpenAI 提供者是无
openrouterApiKeyopenrouter.apiKeyOPENROUTER_API_KEY对选中的 OpenRouter 提供者是肯定的无
stabilityApiKeystability.apiKeySTABILITY_API_KEY选定稳定提供者是无
replicateApiTokenreplicate.apiTokenREPLICATE_API_TOKEN选定复制供应商是无
defaultProvider无无没有第一个配置的提供者 : openai, (中文(简体) ), openrouter, (中文(简体) ), stability, (中文(简体) ), replicate; 否则 openai
defaultModel无无没有gpt-image-2.5-flare 用于OpenAI; google/gemini-2.5-flash-image 用于OpenRouter; stable-image-core (一) 促进稳定; black-forest-labs/flux-schnell 复制
defaultSize无无没有1024x1024
defaultQuality无无没有medium 用于 OpenAI GPT 图像模型; 否则未设置
imageDir无AGENTOS_IMAGE_DIR没有猪头: os.tmpdir()/agentos-images-${process.getuid()}; 视窗 : os.homedir()/AppData/Local/Temp/agentos-images
saveImage无无没有在本地保存图像数据并返回 a file: 網址
priority无无没有50

从选项中解出密钥 getSecret,然后是环境变量。 运算标记每个提供者的秘密可选,但生成需要选定提供者的密钥. 一个工具呼叫 provider 覆盖 defaultProvider;它的模型,大小和质量压倒了它们的包默认值.

工具

工具它会做什么
generate_image利用配置的提供者从文本提示生成图像并返回其 URL.

generate_image

参数类型需求说明
promptstring对要生成的图像的详细文本描述 。 具体介绍风格,主题,构成,照明,和心情.
sizestring没有图像尺寸 : 1024x1024 (平方,默认), 1536x1024 或者说 1792x1024 (景观), 1024x1536 或者说 1024x1792 (相传.
aspectRatiostring没有支持它的提供者的可选侧面比提示 .
qualitystring没有图像质量 : low, (中文(简体) ), medium (违约), high,或 auto。 。 。 . standard 财务报告和审定财务报表 hd 改为 medium 财务报告和审定财务报表 high更高的质量成本.
stylestring没有可选样式 : vivid 对于超现实和戏剧性, natural 为了更现实.
providerstring没有要使用的 AI 提供者 : openai, (中文(简体) ), openrouter, (中文(简体) ), stability 或者说 replicate。如果省略,扩展使用它所配置的默认提供者.
modelstring没有可选:提供商自己的型号代号.
seednumber没有支持可复制图像生成的提供者的可选种子 .
negativePromptstring没有支持特定特征或文物以外的提供者可选择负面提示.

页:1

软件包需要节点.js >=22。世代通话可产生图像收费。 缺少证书会生成一个失败的工具结果来命名选定的提供者的环境变量和密钥页面. 空出提示,无效的计划值,提供者出错和存储失败也返回失败的结果.

用于 OpenAI GPT 图像模型,服务地图 standard 质量到 medium 财务报告和审定财务报表 hd 改为 high。它将选定的样式作为文本添加到提示中,而不是发送样式参数。 其他型号路线在没有这种转换的情况下获得质量.

结果使用提供者返回的第一个图像。 提供商HTTP(S) URL通过不变. 图像数据被保存为PNG,JPEG或WebP,并返回为URL而不是碱基64. 该工具忽略了它计划外的字段, 包括 n 财务报告和审定财务报表 providerOptions。 。 。 .

默认保存器在调用提供者前检查存储 。 在POSIX上,图像目录属于服务用户,并禁止由其他用户编写. 它的父母属于该用户或根,并且禁止其他用户的写作,除非粘着. 已保存的图像由 context.userContext.userId,或存储在 shared 当缺席时。 包不删除已保存的图像 .

习惯 saveImage 接收 bytes, (中文(简体) ), mimeType, (中文(简体) ), tool 财务报告和审定财务报表 context,并必须返回通过保存器长度检查的 HTTP(S) URL。 A 类 file: URL 是指运行工具的机器; 拥有远程客户端供应的主机 saveImage。 。 。 .

释放

新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .

许可证

阿帕奇 - 2.0

版本与发布记录

@framers/agentos-ext-image-generation 共发布 10 个版本,首次发布于 2026/03/16;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.1.3latest2026/11/0214 天前
2.1.22026/11/0114 天前
2.1.12026/11/0115 天前
2.1.02026/10/121 个月前
2.0.12026/10/121 个月前
2.0.02026/10/111 个月前

关于 @framers/agentos-ext-image-generation 的常见问题

@framers/agentos-ext-image-generation 是什么?

AgentOS的图像生成扩展——OpenAI,OpenRouter,稳定AI,和复制

如何安装 @framers/agentos-ext-image-generation?

在项目目录运行 npm install @framers/agentos-ext-image-generation,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@framers/agentos(>=0.10.40)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@framers/agentos-ext-image-generation 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@framers/agentos-ext-image-generation 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@framers/agentos-ext-image-generation 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@framers/agentos-ext-image-generation 可以商用吗?

@framers/agentos-ext-image-generation 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@framers/agentos-ext-image-generation 的下载量有多少?

根据 npm 官方下载统计,@framers/agentos-ext-image-generation 在 2026/10/16 – 2026/11/14 这 30 天内被下载 21,570 次,日均约 719 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@framers/agentos-ext-image-generation 还在维护吗?

最新版本 2.1.3 发布于 2026/11/02(14 天前);至今共发布 10 个版本,其中过去 12 个月发布了 10 个;首次发布于 2026/03/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。