# @framers/agentos-ext-image-generation 中文文档

规范地址：https://npmcn.com/package/%40framers/agentos-ext-image-generation/

版本：2\.1\.3
npm 元数据更新时间：2026-11-01T21:58:56.691Z
中文译文更新时间：2026-11-15T12:04:50.361Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40framers/agentos-ext-image-generation
原文对照：https://npmcn.com/package/%40framers/agentos-ext-image-generation/?lang=original
项目主页：https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/tools/image-generation#readme
源码仓库：https://github.com/framerslab/agentos-extensions

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：109 kB，24 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：@framers/agentos \>=0\.10\.40
- 首次发布：2026-03-16T01:07:17.976Z
- 最新版本发布：2026-11-01T21:58:56.384Z
- 近 30 天下载量：21570（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

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

## 安装

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

也可以使用：`pnpm add @framers/agentos-ext-image-generation`、`yarn add @framers/agentos-ext-image-generation`、`bun add @framers/agentos-ext-image-generation`

## README

# 图像生成

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

## 安装

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

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

## 使用量

```ts
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,
        },
      },
    ],
  },
});
```

## 配置

| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
| --- | --- | --- | --- | --- |
| `openaiApiKey` | `openai.apiKey` | `OPENAI_API_KEY` | 对选中的 OpenAI 提供者是 | 无 |
| `openrouterApiKey` | `openrouter.apiKey` | `OPENROUTER_API_KEY` | 对选中的 OpenRouter 提供者是肯定的 | 无 |
| `stabilityApiKey` | `stability.apiKey` | `STABILITY_API_KEY` | 选定稳定提供者是 | 无 |
| `replicateApiToken` | `replicate.apiToken` | `REPLICATE_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`

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

## 页: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`。 。 。 .

## 释放

新版本发表于 [架设层/剂-外延](https://github.com/framerslab/agentos-extensions) 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @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 和提交记录判断。