@ agent-forge/ 插件- 图像生成
代理 Forge 的第一当事方图像生成能力插件 。 登记
image_generate 财务报告和审定财务报表 image_edit 工具(全控制主机)与
主机配置提供者的图像端点( OpenAI 兼容请求形状)
默认情况下, 使用 Grok 想象编辑适配器 :
- 全权证书
apiKey+ 键baseUrl)在运行时通过公众解决CredentialAPI(单位:千美元)api.credentials.resolve({ providerId })); 插件保留 没有自己的证书. provider编号 :model编号 :baseUrl来自所选会话generate_image目标(/model; 调用不能覆盖它们。 第一个 适配器是openai-images。 。 。 .capabilityConfig.generate_image.options可能提供默认size, (中文(简体) ),quality财务报告和审定财务报表n; 明确的工具参数胜出.- 没有能力选择服务的主机又回到了遗产 能力槽链(设置插槽、掩体、提供者推论)。 使用新主机 仅选择会话.
- 生成和编辑的图像文件被写入工作空间
generated-images/目录,按其实际格式命名和输入 (魔法字节嗅觉:png/jpg/webp/gif;未知倒回png);工具 结果只返回工作空间相对路径( 见“ 图像从不骑行 ” —— 模型读取一个返回的文件来查看. - 取消级联通过
api.sessionAbortSignal()和援引 信号; 180s后请求超时, 错误消息从不响应 API 键或请求头. - 来自图像 API 的 401/403 报告为
credentials_insufficient(无)image_request_failed: 信件名称为被拒绝的密钥和点 特定供应商的auth.json输入。 单一的网关密钥往往有 文本能力但无图像能力, 因此注册专用图像密钥 用于图像提供者,而不是重用主提供者. - 图像编辑使用提供者的
/images/edits终点 插件选择 模式ID中的请求协议 :grok-imagine-image财务报告和审定财务报表grok-imagine-image-*使用 Grok JSON 数据- URL 形状; 其他模型使用 OpenAI多块. 提供方证书和端点配置保持不变 提供主机 .
配置图像提供者
将模型注册到 models.json中选择 /model →(或设置)
settings.defaultCapabilities.generate_image) (中文(简体) ). 这个 settings.json 下面是
仅由没有能力选择服务的主机使用 :
{
"capabilities": {
"imageGeneration": { "provider": "myimg", "model": "gpt-image-1" }
}
}
models.json 登记提供者及其图像模型(capabilities
标记图像能力模型; 适配器选择图像协议 :
{
"providers": {
"myimg": {
"baseUrl": "https://img.example.com/v1",
"api": "openai-completions",
"models": [
{
"id": "gpt-image-1",
"capabilities": ["generate_image"],
"capabilityConfig": { "generate_image": { "adapter": "openai-images" } }
}
]
}
}
}
图像生成只消耗 baseUrl、供应商证书,以及
模式 id; 聊天模式字段, 如 contextWindow编号 :maxTokens 不影响
图像请求并可以省略(仅声明它们更改
--list-models 显示).
用 /login (存储于 auth.json(三); models.json
拒绝 apiKey 字段装入。 插件解决密钥和 baseUrl
通过主机的证书 API:存储的密钥生活在 auth.json,以及
models.json 不是一个关键来源 --api-key/运行时间注入和
供应商注册的密钥也解决了.
只有一个 models.json 登记(无) capabilities 设置)
插件自动使用单个已注册图像提供者(引用层 4/ 5).
正在注册图像模型 models.json 意味着供应商真的有
a 一个 /images/generations 结束点; 聊天模式从未参与
在推论中。 槽通过主机运行到插件
装配时间 configOverride 注射(api.config.imageGeneration + 键
api.config.imageModelCatalog 快照)——插件从未读取主机
设置文件本身.
代理支持
每个外出请求(API呼叫和提供者-CDN图像下载)都尊重
标准代理环境变量 - HTTPS_PROXY, (中文(简体) ), HTTP_PROXY, (中文(简体) ), NO_PROXY
(这两种情况都有效,与卷轴/起伏/npm相同)
EnvHttpProxyAgent,每个请求注入。 节点的 fetch 忽略这些
默认变量,所以如果您的机器只通过一个
VPN/代理客户端,在运行主机之前导出其本地的 HTTP 端口,例如:
export HTTPS_PROXY=http://127.0.0.1:7897
export NO_PROXY=api.shenwenai.com # optional: keep the gateway direct
OS级代理设置( MacOS 网络设置, Windows 注册) 不是 读; 手动导出端口。 全球调度员从未被替换——只有 此插件的请求受到影响 .
注释:
HTTP(S)_PROXY必须指向 网页 代理( 多数 VPN 客户端曝光 a) 混合 http/socks 端口;使用带有http://URL) (中文(简体) ).socks5://URL以明显的错误被拒绝——undici只说出http代理.ALL_PROXY未读( 不可分割的限制); 设置HTTP_PROXY编号 :HTTPS_PROXY。 。 。 .- 主机本身已经为模型流量遵守这些变量
它自己的全球调度器( http- despatcher )
EnvHttpProxyAgent);这个 插件的包装器存在, 因此图像流量也会在不运行的主机中工作 安装全局调度器( 内嵌主机), 并拒绝袜子 URL 带一个可操作的信息. - 重签名 TLS 所需的企业代理
NODE_EXTRA_CA_CERTS与 代理的根证书 .
图像从不载客(按需阅读)
图像有效载荷是 从未内含 他们将会是
以后每转一次都重新接受模型. 工具结果包含结论
仅限: {files, model, usage} 加上一个说明 告诉模型阅读文件.
当模型实际需要考察其生产(如修改)时,
它读取文件——主机 read 工具将图像作为附件和
自动调整大小,比携带生的更便宜,更精确
历史上的载荷. 让你的谈话模型看到图像,宣布
"capabilities": ["text", "visual_image"] 在供货商那里 models.json
条目(主机将图像部分降为仅限文本的模型,并带有可读注释).