codegrazier/cpa-image
codegrazier/cpa-image has 77 GitHub stars and 13 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 16:33 UTC. Last push 2026-09-04.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
CPA Image 是一个本地优先的 OpenAI 兼容图像生成与编辑控制台。
Creative & MediaREADME.md
OriginalCPA Image
CPA Image 是一个本地优先的 OpenAI 兼容图像生成与编辑控制台。
界面使用 React、TypeScript、Vite、Tailwind CSS 和 shadcn/ui 构建。应用本身不提供后端服务,所有请求都从浏览器发往用户配置的 OpenAI 兼容 API 地址。
功能
- 生成与编辑:支持文字生成图片、选择本地图片编辑、复用历史结果作为编辑输入。
- 多接口调试:支持
/v1/images/generations、/v1/images/edits、/v1/responses、/v1/chat/completions。 - 队列控制:支持批量请求、并发数量、请求间隔、取消运行中请求、清理失败或已完成请求。
- 本地工作流:支持 Prompt 历史、置顶、复用、图片下载、批量导出 ZIP、响应 JSON 查看。
- 国际化:支持中文和英文界面,并在地址路径中保留语言状态。
开发
建议使用 Node.js 24 或更高版本;如果使用 nvm,可以直接运行 nvm use 读取 .nvmrc 中的推荐版本。Node < 24 的 undici Blob 与 jsdom 在测试环境下不互通,会导致 npm test 中 URL 图片转 blob 的用例失败。
项目源码以 MIT 许可证开源,但不作为 npm 包发布;package.json 中的 private: true 用于避免误发布。
npm install
npm start
默认开发地址是 http://127.0.0.1:5174。
配置
页面默认 API URL 是 http://localhost:8317/v1。如果你的代理或兼容服务部署在其他地址,可以直接填写根地址,例如 https://proxy.example.com,应用会按功能自动拼接接口路径:
- 图片生成:
/v1/images/generations - 图片编辑:
/v1/images/edits - Responses:
/v1/responses - Chat Completions:
/v1/chat/completions - 连接测试:
/v1/models
本地数据
CPA Image 会把设置、Prompt 历史、请求摘要和请求详情保存在当前浏览器本地,用于刷新后恢复工作区。API Key 只有在勾选“在本浏览器记住 API Key”后才会持久化保存。
项目不会主动把本地缓存上传到第三方服务。导出 ZIP、下载图片和查看响应 JSON 都在浏览器端完成。
跨域代理
如果目标 API 没有正确配置 CORS,浏览器会阻止请求。页面提供“启用跨域请求代理”选项作为兜底方案:启用后,请求会先经过代理服务转发。
跨域代理可能接触到 API URL、请求头、Prompt、图片和响应内容。只在你信任该代理服务时启用;更推荐在自己的 API 网关上正确配置 CORS。
验证
npm test
npm run build
git diff --check
npm run build 会先执行 TypeScript 类型检查,再构建静态资源并运行预渲染脚本。
许可证
本项目采用 MIT 许可证,详见 LICENSE。