mcpField
G
gpt-image-2.5

gpt-image-2.5

github.com/finpeakinc创意与媒体255 次安装4 天前更新
代码仓库

关于 gpt-image-2.5

用于通过 Frevana AI Factory OpenAI 图像接口生成或编辑图像的技能。它依据速度与精度需求选择 GPT Image 2.5 模型，并通过脚本提交参数、参考图和凭据。

主要功能

  1. 01按需求选择 Flare 或 Sunburst
  2. 02支持文本生成与参考图编辑
  3. 03可指定尺寸、质量和输出格式
  4. 04可处理本地、远程及目录参考图
  5. 05返回验证后的 API JSON 或图像 URL

适用场景

  1. 01快速制作社交媒体或原型图像
  2. 02保留参考图细节进行编辑
  3. 03生成带精确文字或复杂布局的成品图

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/finpeakinc/frevana-skills --skill gpt-image-2.5

安装后在 Claude Code 中输入/gpt-image-2.5确认已加载。

附带文件scripts/generate_image.shtests/test_generate_image.py

详细介绍

GPT Image 2.5

通过 Frevana 的 AI Factory OpenAI 图像端点生成或编辑图像。

原样返回经过验证的 API 响应 JSON。将 data[0].image_url 视为主要图像 URL。

模型选择

  • 遵循用户明确选择的 gpt-image-2.5-flare 或 gpt-image-2.5-sunburst。
  • 否则，大多数请求使用 gpt-image-2.5-flare，尤其是快速迭代、社交媒体／创作者内容、原型、视觉搜索、产品体验或高产量生成。
  • 当请求优先考虑最高精度而非延迟时，使用 gpt-image-2.5-sunburst：例如要求严格保留参考图像、精细控制或重复编辑、可直接用于生产的营销创意、精美的产品图像、复杂布局，或精确的文字／细节处理。
  • 如果请求没有明确理由使用 Sunburst，就使用 Flare。除非速度与精度之间的权衡会实质性影响请求，否则不要询问用户如何选择。

省略 --model 时，脚本默认使用 Flare。如果 Agent 选择了 Sunburst，请明确传入所选模型。

此技能所需内容

  • 用户提供的 prompt 或 contents
  • 可选参考输入：--image、--image-url、--image-dir、--mask
  • 可选图像设置：n、size、quality、background、output_format、output_compression、moderation、input_fidelity
  • FREVANA_TOKEN，或仅用于本次运行的 --token 覆盖值
  • 可选的 FREVANA_AGENT_APP_INSTANCE_ID；非空时，脚本会在图像生成请求中将其作为 x-frevana-agent-app-instance-id 标头发送
  • curl、bash 和 python3

执行

  1. 确认用户提供了提示词。
  2. 根据上述规则选择模型，并优先使用随附脚本，而非临时构造请求。
  3. 将本地图像映射为可重复使用的 --image，将远程图像 URL 映射为可重复使用的 --image-url，将目录映射为可重复使用的 --image-dir。
  4. 仅在编辑／参考图像请求中使用 --input-fidelity。需要保留精确的人脸、产品、排版或其他源图细节时，使用 high；否则省略此选项，让 API 应用默认值。
  5. 仅在不含参考图像的文生图请求中使用 --moderation。
  6. 让脚本优先使用 FREVANA_TOKEN。在非交互式运行中，如果缺少令牌，应报告令牌缺失，而不是无限期提示输入。
  7. 当 FREVANA_AGENT_APP_INSTANCE_ID 非空时，让脚本在图像生成请求中将其作为 x-frevana-agent-app-instance-id 附加。
  8. 返回原始 JSON；如果用户只请求第一个托管 URL，则仅返回该 URL。适用时使用 --output 保存 JSON。

允许的选项

  • --model：gpt-image-2.5-flare 或 gpt-image-2.5-sunburst；默认使用 Flare
  • --n：1-10
  • --size：auto 或 WIDTHxHEIGHT；每条边最长为 3840 且必须能被 16 整除，宽高比不得超过 3:1，总像素数须在 655360 至 8294400 之间
  • --quality：auto、low、medium、high、xhigh、max
  • --background：auto、opaque、transparent；透明输出需要 PNG 或 WebP
  • --output-format：png、jpeg、webp
  • --output-compression：1-100，仅适用于 JPEG 或 WebP
  • --moderation：auto、low，仅用于生成
  • --input-fidelity：low、high，仅适用于编辑／参考图像请求
  • --image：可重复指定的本地 .png／.jpg／.jpeg／.webp 文件，大小须低于 50MB
  • --image-url：可重复指定的远程 HTTP(S) 图像；上传前会先下载，大小须低于 50MB
  • --image-dir：可重复指定的本地目录，会递归加载；参考图像总数最多为 16 张
  • --mask：可选的本地 PNG，大小须低于 4MB，且仅可与参考图像搭配使用

像素数超过 3686400 的分辨率属于实验性选项。除非用户需要自定义画布，否则优先使用 1024x1024、1536x1024、1024x1536、2048x2048、2048x1152、3840x2160 或 2160x3840 等常见尺寸。

命令

bash <skill-path>/scripts/generate_image.sh \
  --prompt "A cinematic product photo of a matte black espresso machine on travertine" \
  --size 2048x1152 \
  --quality high \
  --output-format png \
  --output ./out/gpt-image-2.5-result.json

bash <skill-path>/scripts/generate_image.sh \
  --model gpt-image-2.5-sunburst \
  --prompt "Change only the label typography and preserve the product exactly" \
  --image ./refs/product.png \
  --input-fidelity high \
  --quality xhigh \
  --background transparent \
  --output-format webp \
  --output ./out/gpt-image-2.5-edit-result.json

注意事项

  • 将后端路由固定为 POST /openai/image/generate；只能选择两个 GPT Image 2.5 模型 ID。
  • 生成和编辑都必须提供 prompt。
  • 除非收到请求，否则不要重写、代理或转换返回的 Frevana 图片 URL。
  • 该脚本有意不实现流式传输或 partial_images，因为 Frevana 端点目前只返回一份完整的 JSON 响应。

评论

支持 Markdown