{"id":17793391,"url":"https://github.com/aigem/cf-flux-remix","last_synced_at":"2025-07-24T10:34:50.786Z","repository":{"id":258547128,"uuid":"869453625","full_name":"aigem/cf-flux-remix","owner":"aigem","description":"免费使用Workers AI 的FLUX.1生成图片（前端+API）超简单部署在CF Workers中","archived":false,"fork":false,"pushed_at":"2024-10-17T11:15:40.000Z","size":270,"stargazers_count":89,"open_issues_count":7,"forks_count":179,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-26T09:42:39.740Z","etag":null,"topics":["ai","api","cloudflare","cloudflare-workers","flux","free","remix","text-to-image","workers-ai"],"latest_commit_sha":null,"homepage":"https://flux.remix.us.kg/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aigem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-08T10:19:55.000Z","updated_at":"2025-05-04T18:37:15.000Z","dependencies_parsed_at":"2024-10-19T14:06:43.637Z","dependency_job_id":null,"html_url":"https://github.com/aigem/cf-flux-remix","commit_stats":null,"previous_names":["aigem/cf-flux-remix"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aigem/cf-flux-remix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aigem%2Fcf-flux-remix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aigem%2Fcf-flux-remix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aigem%2Fcf-flux-remix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aigem%2Fcf-flux-remix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aigem","download_url":"https://codeload.github.com/aigem/cf-flux-remix/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aigem%2Fcf-flux-remix/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266828624,"owners_count":23991219,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","api","cloudflare","cloudflare-workers","flux","free","remix","text-to-image","workers-ai"],"created_at":"2024-10-27T11:08:20.514Z","updated_at":"2025-07-24T10:34:50.735Z","avatar_url":"https://github.com/aigem.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CF Flux Remix\n\nCF Flux Remix 是一个基于 Cloudflare Workers 和 Remix 框架的图像生成应用。它利用 Cloudflare 的 AI 模型来生成图像，并提供了一个用户友好的界面和 API 接口来与这些模型进行交互。\n\n## 功能特点\n\n- 使用 Cloudflare 的 AI 模型生成图像【免费】\n- 支持多种图像生成模型，包括 Flux 和标准模型\n- 提供 API 接口以便集成到其他应用中\n- 支持提示词翻译和优化\n- 一键部署\n- 响应式设计，现代设计\n- 图片生成不受限制(不经审查)，你懂的\n\n## 快速开始\n\n### 前置条件\n\n- CloudFlare账号\n- Github/Gitlab账号\n\n## 安装 \n### [视频教程](https://www.bilibili.com/video/BV1Wz2NYyEmW/)\n\n1. 克隆（Fork）仓库：\n   ```bash\n   https://github.com/yourusername/cf-flux-remix\n   ```\n\n2. 完成部署：\n  在CloudFlare中操作\n   ```bash\n   1、新建一个worker\n   名称为 free-flux . 注意此名称必须与Github中的Wrangler.toml文件中的名称一致。\n   \n   2、worker后台设置中绑定Github仓库\n   绑定Fork的本仓库\n   \n   3、填入构建命令等\n   构建命令（可选）： pnpm i\n   部署命令： pnpm run deploy\n\n   4、触发CF Workers中部署\n   随便改动一下仓库readme文件，提交后自动触发部署\n\n   5、部署完成\n   部署完成后打开相应网站来使用，API使用看下面的说明\n   记得在worker后台设置环境变量，替换自己的CF账号ID及API令牌\n   API令牌要有Workers AI 的读取及编辑权限。\n\n   ```\n\n### 开发\n\n运行开发服务器：\n```\npnpm run dev\n```\n\n### 构建和部署\n\n1. 另一种方法部署到 Cloudflare Workers：\n   ```\n   pnpm run deploy\n   ```\n  \n## 环境变量\n\n在 `wrangler.toml` 文件中设置以下程序变量：\n\n- `API_KEY`: API 密钥，用于身份验证\n- `CF_ACCOUNT_LIST`: Cloudflare 账户列表，JSON 格式\n- `CF_TRANSLATE_MODEL`: 翻译模型 ID\n- `CF_IS_TRANSLATE`: 是否启用翻译功能\n- `USE_EXTERNAL_API`: 是否使用外部 API\n- `EXTERNAL_API`: 外部 API 地址\n- `EXTERNAL_MODEL`: 外部模型 ID\n- `EXTERNAL_API_KEY`: 外部 API 密钥\n- `FLUX_NUM_STEPS`: Flux 模型的步数\n- `CUSTOMER_MODEL_MAP`: 模型映射，JSON 格式\n\n## API 文档\n\n### 生成图像\n\n- 端点：`/api/image`\n- 方法：POST\n- 请求头：\n  - `Authorization: Bearer your_api_key_here`\n  - `Content-Type: application/json`\n- 请求体：\n  ```json\n  {\n    \"messages\": [{\"role\": \"user\", \"content\": \"图像描述\"}],\n    \"model\": \"模型ID\",\n    \"stream\": false\n  }\n  ```\n- 响应：\n  ```json\n  {\n    \"prompt\": \"原始提示词\",\n    \"translatedPrompt\": \"翻译后的提示词\",\n    \"image\": \"生成的图像数据（Base64编码）\"\n  }\n  ```\n\n### 获取可用模型\n\n- 端点：`/api/models`\n- 方法：GET\n- 请求头（可选）：\n  - `Authorization: Bearer your_api_key_here`\n- 响应：\n  ```json\n  {\n    \"models\": [\n      {\"id\": \"DS-8-CF\", \"name\": \"DreamShaper 8\"},\n      {\"id\": \"SD-XL-Bash-CF\", \"name\": \"Stable Diffusion XL Base\"},\n      {\"id\": \"SD-XL-Lightning-CF\", \"name\": \"Stable Diffusion XL Lightning\"},\n      {\"id\": \"FLUX.1-Schnell-CF\", \"name\": \"Flux 1 Schnell\"}\n    ]\n  }\n  ```\n\n## 使用示例\n\n### 使用 cURL 生成图像\n```\nbash\ncurl -X POST https://your-worker-url.workers.dev/api/image \\\n-H \"Authorization: Bearer your_api_key_here\" \\\n-H \"Content-Type: application/json\" \\\n-d '{\n\"messages\": [{\"role\": \"user\", \"content\": \"一只可爱的猫咪\"}],\n\"model\": \"DS-8-CF\"\n}'\n```\n\n### 使用 Python 请求 API\n```\npython\nimport requests\nimport json\nurl = \"https://your-worker-url.workers.dev/api/image\"\nheaders = {\n\"Authorization\": \"Bearer your_api_key_here\",\n\"Content-Type\": \"application/json\"\n}\ndata = {\n\"messages\": [{\"role\": \"user\", \"content\": \"一只可爱的猫咪\"}],\n\"model\": \"DS-8-CF\"\n}\nresponse = requests.post(url, headers=headers, data=json.dumps(data))\nresult = response.json()\nprint(f\"原始提示词: {result['prompt']}\")\nprint(f\"翻译后的提示词: {result['translatedPrompt']}\")\nprint(f\"生成的图像数据: {result['image'][:50]}...\") # 只打印前50个字符\n```\n\n## 贡献\n\n欢迎提交 Pull Requests 来改进这个项目。对于重大更改，请先开 issue 讨论您想要改变的内容。\n\n## 许可证\n\n本项目采用 MIT 许可证。详情请见 [LICENSE](LICENSE) 文件。\n\n## 常见问题\n\n1. Q: 如何添加新的模型？\n   A: 在 `wrangler.toml` 文件中的 `CUSTOMER_MODEL_MAP` 变量中添加新的模型 ID 和对应的 Cloudflare AI 模型路径。\n\n2. Q: 如何禁用翻译功能？\n   A: 在 `wrangler.toml` 文件中将 `CF_IS_TRANSLATE` 设置为 \"false\"。\n\n3. Q: 如何调整 Flux 模型的步数？\n   A: 修改 `wrangler.toml` 文件中的 `FLUX_NUM_STEPS` 值。\n\n## 故障排除\n\n如果遇到问题，请检查以下几点：\n\n1. 确保所有环境变量都已正确设置。\n2. 检查 Cloudflare 账户和 API 令牌是否有效。\n3. 确保使用的模型 ID 在 `CUSTOMER_MODEL_MAP` 中存在。\n4. 查看 Cloudflare Workers 的日志以获取更详细的错误信息。\n5. The name in `wrangler.toml` must match the name of your Worker.\n\n如果问题仍然存在，请开一个 issue 并提供详细的错误信息和复现步骤。\n\n### [视频教程](https://www.bilibili.com/video/BV1Wz2NYyEmW/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faigem%2Fcf-flux-remix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faigem%2Fcf-flux-remix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faigem%2Fcf-flux-remix/lists"}