图像生成
这个包通过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,
},
},
],
},
});
配置
| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
|---|---|---|---|---|
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。 。 。 .
释放
新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .
许可证
阿帕奇 - 2.0