mcpField
A
apimart-image-gen

apimart-image-gen

github.com/kangarooking创意与媒体68847 次安装7 周前更新
代码仓库

关于 apimart-image-gen

APIMart Image Gen 是通过 APIMart 使用 GPT-Image-2 生成图像的技能，可提交异步任务、查询状态并下载结果。它支持文本提示词，以及 URL 或本地文件作为参考图。

主要功能

  1. 01提交 GPT-Image-2 图像任务
  2. 02根据文本提示词生成图像
  3. 03使用 URL 和本地文件作为参考图
  4. 04轮询任务状态并下载结果
  5. 05通过 dry-run 校验请求格式

适用场景

  1. 01根据文字描述生成图像
  2. 02转换或融合参考图
  3. 03查询已有任务并下载输出
  4. 04提交前校验图像生成参数

安装

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

$npx skills add https://github.com/kangarooking/kangarooking-skills --skill apimart-image-gen

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
api.md
scripts/
apimart_image_gen.py

详细介绍

APIMart 图像生成

使用此技能向 APIMart 提交 GPT-Image-2 图像任务、轮询异步任务结果，并下载返回的图像 URL。

凭据规则

从环境变量读取 API 密钥。不要将 API 密钥硬编码在提示词、脚本、技能文件、zip 包、提交记录或 shell 历史记录中。

首选变量：

export APIMART_API_KEY="..."

此辅助工具也接受 APIMART_TOKEN 作为备用变量。

快速开始

常规请求请使用随附的辅助工具：

python scripts/apimart_image_gen.py generate \
  --prompt "一只橘猫坐在窗台上看夕阳，水彩画风格" \
  --size "16:9" \
  --resolution "2k" \
  --output-dir ./outputs/apimart-image-gen

脚本会提交 POST /v1/images/generations，在首次轮询前等待一段时间，查询 GET /v1/tasks/{task_id}，并将已完成的图像 URL 下载到 --output-dir。

工作流

文生图：

python scripts/apimart_image_gen.py generate \
  --prompt "a corgi astronaut on the moon, cinematic" \
  --size "16:9" \
  --resolution "2k"

使用公开 URL 进行图生图：

python scripts/apimart_image_gen.py generate \
  --prompt "把参考图变成水彩画风格" \
  --image-url "https://example.com/photo.jpg" \
  --size "4:3" \
  --resolution "2k"

使用本地文件进行图生图：

python scripts/apimart_image_gen.py generate \
  --prompt "融合这些参考图，生成一张公众号封面" \
  --image-file ./reference-a.png \
  --image-file ./reference-b.jpg \
  --size "21:9" \
  --resolution "2k"

检查现有任务：

python scripts/apimart_image_gen.py status \
  --task-id task_01KPQ7J7DWB7QZ3WCEK3YVPBRA \
  --download \
  --output-dir ./outputs/apimart-image-gen

验证请求格式，但不调用 API：

python scripts/apimart_image_gen.py generate \
  --prompt "星空下的古老城堡" \
  --size "16:9" \
  --resolution "4k" \
  --dry-run

默认值与限制

  • 模型固定为 gpt-image-2。
  • n 固定为整数 1；不要将 "1" 作为字符串发送。
  • 有效的 resolution 值为 1k、2k 和 4k。
  • 有效的比例值为 auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9 和 9:21。
  • 也接受 1881x836 或 887x1774 等像素尺寸。
  • 通过 --image-url 和 --image-file 最多可提供 16 张参考图像。
  • 建议在 --size 中指定宽高比，而不是写在提示词中，以免指令冲突。
  • APIMart 会报告 expires_at 时间戳，因此应尽快下载结果 URL。

参考

需要了解端点详情、状态值、错误处理或尺寸／分辨率对应表时，请阅读 references/api.md。

评论

支持 Markdown