image2api

image2api 是一个给 Codex / OpenCode 使用的生图技能。它不会调用官方图片生成接口，而是通过你自己配置的第三方图片 API 来生成图片。

适合这些场景：

• Codex 当前接入的不是官方 API，不能直接生图。
• 你有第三方 OpenAI 兼容图片接口。
• 你想在 Codex / OpenCode 对话里说“生成一张图片”时自动调用自己的图片 API。

文件说明

• image2api/SKILL.md：技能触发说明和使用流程。
• image2api/scripts/generate_image.py：实际调用图片 API 的 Python 脚本，无需额外安装依赖。
• image2api/references/configuration.md：详细配置说明。
• image2api/agents/openai.yaml：Codex 界面元数据。
• image2api.zip：离线安装包，下载后解压即可安装。

离线安装

从仓库下载 image2api.zip，然后解压。

解压后应该得到这个目录：

image2api/
  SKILL.md
  scripts/
  references/
  agents/

安装到 Codex

Windows：

Expand-Archive .\image2api.zip -DestinationPath "$HOME\.codex\skills" -Force

如果你已经解压出 image2api 文件夹，也可以复制：

Copy-Item -Recurse -Force ".\image2api" "$HOME\.codex\skills\image2api"

Debian / Linux：

mkdir -p ~/.codex/skills
unzip image2api.zip -d ~/.codex/skills

安装后重启 Codex。

安装到 OpenCode

Windows：

Expand-Archive .\image2api.zip -DestinationPath "$HOME\.config\opencode\skills" -Force

如果你已经解压出 image2api 文件夹，也可以复制：

Copy-Item -Recurse -Force ".\image2api" "$HOME\.config\opencode\skills\image2api"

Debian / Linux：

mkdir -p ~/.config/opencode/skills
unzip image2api.zip -d ~/.config/opencode/skills

安装后重启 OpenCode。

配置图片 API

推荐使用新的环境变量名：

IMAGE2API_URL
IMAGE2API_KEY
IMAGE2API_MODEL

Windows PowerShell 长期生效配置：

[Environment]::SetEnvironmentVariable("IMAGE2API_URL", "https://example.com/v1/images/generations", "User")
[Environment]::SetEnvironmentVariable("IMAGE2API_KEY", "你的API密钥", "User")
[Environment]::SetEnvironmentVariable("IMAGE2API_MODEL", "你的图片模型名", "User")

设置完成后需要重启 Codex / OpenCode。

Debian / Linux：

echo 'export IMAGE2API_URL="https://example.com/v1/images/generations"' >> ~/.bashrc
echo 'export IMAGE2API_KEY="你的API密钥"' >> ~/.bashrc
echo 'export IMAGE2API_MODEL="你的图片模型名"' >> ~/.bashrc
source ~/.bashrc

脚本也兼容旧变量名：

• THIRD_PARTY_IMAGE_API_URL
• THIRD_PARTY_IMAGE_API_KEY
• THIRD_PARTY_IMAGE_API_MODEL

测试是否可用

Windows PowerShell：

python .\image2api\scripts\generate_image.py `
  --prompt "一只白色机械猫坐在未来城市屋顶，电影感，高清" `
  --size 1024x1024

Debian / Linux：

python3 image2api/scripts/generate_image.py \
  --prompt "一只白色机械猫坐在未来城市屋顶，电影感，高清" \
  --size 1024x1024

成功后命令会输出生成图片的本地路径。

对话使用

安装并配置后，可以在 Codex / OpenCode 里这样说：

用 $image2api 生成一张未来城市屋顶上的白色机械猫海报，电影感，高清

如果你的环境支持自动触发技能，直接说“生成一张……”也可能自动调用该技能。

默认请求格式

默认按 OpenAI 兼容图片接口发送：

{
  "model": "配置的模型名",
  "prompt": "用户提示词",
  "size": "1024x1024",
  "n": 1,
  "response_format": "b64_json"
}

如果你的服务商请求体或返回字段不同，请看：

image2api/references/configuration.md

安全提醒

不要把 API Key 写进仓库，也不要提交 .env 文件。请使用系统环境变量或密钥管理工具保存 API Key。