[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80907":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":14,"lastSyncTime":29,"discoverSource":30},80907,"api-image","yc-duan\u002Fapi-image","yc-duan","Codex skill for API-based image generation through OpenAI-compatible providers",null,"Python",41,14,33,2,0,4,7,8,12,3.53,"MIT License",false,"main",true,[],"2026-06-12 02:04:08","# api-image\n\n一个给 Codex App 用的图片生成 Skill。\n\n它的作用很简单：当你在 API 形式使用 Codex App，没法直接用官方内置 `imagegen` 时，让 Codex 改走你自己配置的 OpenAI-compatible 图片接口，例如通过 CPA 反代出来的 `gpt-image-2`。\n\n用网页版生过图的朋友应该知道，网页端的生图不是单纯“把一句 prompt 传给图片模型”。它更像一个 agent：主模型会理解你的需求，必要时搜索资料、分析参考图、整理提示词，然后再调用图片模型。这个 Skill 就是尽量复刻这种流程：你用自然语言告诉 Codex 想要什么，Codex 负责前面的 agent 工作，最后通过你的 Provider API 生图。\n\n## 它能做什么\n\n- 文生图\n- 参考图生图\n- 局部编辑 \u002F inpainting\n- 多参考图辅助构图、风格、产品或人物一致性\n- 需要真实信息的图片生成前，先让 Codex 搜索和整理参考资料\n- 默认读取你 Codex 根目录里的 Provider 配置\n- 临时切换本次调用使用的 URL 或 API Key\n\n更细的调用规则和脚本参数都在 [SKILL.md](.\u002FSKILL.md) 里，README 只讲怎么用。\n\n## 安装\n\n把仓库放到 Codex 的 skills 目录：\n\n```powershell\ngit clone \u003Crepo-url> \"$env:USERPROFILE\\.codex\\skills\\api-image\"\n```\n\n如果你设置了 `CODEX_HOME`：\n\n```powershell\ngit clone \u003Crepo-url> \"$env:CODEX_HOME\\skills\\api-image\"\n```\n\n然后重启 Codex App，或让 Codex 重新加载 Skills。\n\n## 配置\n\n默认情况下，这个 Skill 会读取你 Codex 根目录里的配置：\n\n- `auth.json`\n- `config.toml`\n\n它需要能从里面找到：\n\n- API Key\n- 当前 Provider\n- Provider 的 `base_url`\n\n这个仓库不会、也不应该保存你的 API Key。\n\n## 怎么用\n\n安装后，正常和 Codex 说话就行。比如：\n\n```text\n用 api-image 生成一张 2048x1152 的电影感照片：雨夜东京街头，霓虹反光，真实摄影风格。\n```\n\n带参考图时可以这样说：\n\n```text\n参考这张图的构图和人物姿势，生成一张暖色电影感插画，保持主体姿态，但不要照抄原图。\n```\n\n需要真实地点、产品、建筑、历史服饰这类容易生成错的东西时，可以直接要求 Codex 先查资料：\n\n```text\n先查一下花江峡谷大桥的结构和地形参考，再生成一张高空俯视图，尽量保持真实桥型和峡谷环境。\n```\n\n## 临时换接口\n\n默认会用你 Codex 根目录里的 Provider 配置。\n\n如果只想这一次换 URL 或 key，可以直接告诉 Codex：\n\n```text\n这次生图临时用 https:\u002F\u002Fexample.com\u002Fv1 这个 base_url，API key 从 API_IMAGE_API_KEY 环境变量读。\n```\n\n更推荐让 key 放在环境变量里，不要在聊天里直接粘贴。临时切换只影响本次调用，不会写回你的 `auth.json` 或 `config.toml`，除非你明确要求 Codex 修改配置。\n\n## 关于 gpt-image-2\n\n这个 Skill 默认按 `gpt-image-2` 的官方图片 API 规则处理：\n\n- 纯文生图走 `\u002Fimages\u002Fgenerations`\n- 有参考图、输入图或 mask 时走 `\u002Fimages\u002Fedits`\n- 官方 GPT Image models 默认读返回里的 `b64_json`\n- `gpt-image-2` 不支持透明背景\n- `gpt-image-2` 不需要、也不应该传 `input_fidelity`\n\n如果你的 Provider 对这些参数有自己的兼容层，以 Provider 的实际报错为准。\n\n## 目录\n\n```text\napi-image\u002F\n  SKILL.md\n  README.md\n  LICENSE\n  agents\u002F\n  scripts\u002F\n```\n\n## 说明\n\n这是个人自用 Skill 的整理版，主要目标是让 Codex App 在 API 使用形态下也能比较自然地完成图片生成工作。不同反代和 Provider 的兼容程度可能不一样。\n\nMIT License.\n\n## 致谢\n\n感谢 [linuxdo](https:\u002F\u002Flinux.do\u002F) 社区的交流、分享与反馈。\n","api-image 是一个为 Codex App 设计的图片生成技能，通过与OpenAI兼容的API提供图像生成功能。该项目使用Python编写，支持多种图像处理任务，如文生图、参考图生成、局部编辑以及多参考图辅助构图等，并且能够在需要时让Codex进行资料搜索和整理以提高生成质量。它特别适合于那些希望通过自定义API来增强Codex App图像生产能力的开发者或用户，尤其是在官方内置功能无法满足需求的情况下。此外，项目还允许用户临时切换API URL或Key，提供了灵活的配置选项。","2026-06-11 04:02:47","CREATED_QUERY"]