API 用法
POST/generate
body: {"intent":"...", "ratio":"16:9 | 1:1"} ・ header: X-API-Key: <你的 key>（可省=匿名）
curl -X POST https://fluxgate.cooperation.tw/generate \
-H 'X-API-Key: mk_xxxxx' -H 'Content-Type: application/json' \
-d '{"intent":"高山湖泊日出"}'
# 回 { image_url, flux_prompt, style, width, height, remaining_today }
GET/sse?key=
MCP server（HTTP+SSE，工具 generate_image）。把含 key 的 /sse URL 註冊為 remote MCP，agent / claude.ai 即可直接生圖。
GET/i/<key>
取圖（generate 回傳的 image_url）。圖每日清空，請自行另存。
接到 claude.ai / AI 工具（MCP）
把 FluxGate 接成 MCP server，就能在 claude.ai / Cursor / Codex 的對話裡直接說「生一張圖」。下方 URL 已含你的 key。
連接器 URL（含 key）
先在上方取得 key
複製
1. 先取得 key
用本頁最上方「取得 API Key」拿一把（會員畫質）。匿名也能接，但畫質較低。
2. claude.ai → 新增自訂連接器
設定 → Connectors → Add custom connector，把上面整段 URL 貼到「Remote MCP server URL」。
claude.ai / Add custom connector
名稱FluxGate
Remote MCP server URLhttps://…/sse?key=mk_…
驗證 (Authentication)無驗證 ✓
新增
3. 驗證選「無驗證」
key 已經在 URL 裡，OAuth Client ID/Secret 留白。建立即可。
4. 回對話用 generate_image
對話框工具列勾選 FluxGate，直接說「用 fluxgate 生一張高山日出」。會回圖片 URL。
claude.ai / 對話
+ 工具FluxGate
用 fluxgate 生一張可愛的橘貓
其他 client 設定（key 已預填）
注意：目前 MCP 為 JSON-RPC request/response 版，claude.ai 等需 SSE 串流的 client 未實測，測通請回報，老師會更新。
Claude Desktop（mcp-remote 橋接）複製
先取得 key
Cursor（.cursor/mcp.json）複製
先取得 key
Codex CLI（~/.codex/config.toml）複製
先取得 key
設定成功的判斷- 對話工具列看得到 FluxGate
- 說「生一張…」會回一個 /i/ 圖片 URL
- 點 URL 看得到圖
最常卡住- 用手機/桌面 App 找設定 → 改用網頁版
- 驗證選了 OAuth → 改「無驗證」(key 在 URL)
- 額度用完回 429 → 換 key 或明日再試