# GPT Image 2 API Format (WanJie MaaS 万界方舟) ## ⚠️ GOTCHAS — 避坑(先读!2026-07-07 真机验证) 1. **模型 id 字面就是 `GPT Image 2`(带空格)** —— 不是 gpt-image-2 / image2 / gpt_image_2。 2. **绝对不要传 `responseFormat`(camelCase)** —— 传了会返回纯文本 `文生图获取失败`(22 字节,不是 JSON),生图失败。 - 正确:**请求体只放 `{model, prompt, n, size}`,不带 responseFormat**,默认返回 `data[0].b64_json`(base64 PNG)。 - 如果历史上你遇到「文生图获取失败」→ 就是这个坑,删掉 responseFormat 字段即可。 3. **key 在环境变量 `$WANJIE_API_KEY`** —— 若报未授权/取不到 key,检查该 env 是否设置(见文末「Key 配置」)。若 env 缺失才降级本地 PIL;env 配好后**优先用 GPT Image 2**(质量远超 PIL)。 4. 生成的图要发微信时:**先存到 `/sdcard/Pictures/` 并触发 MediaStore 扫描**,再用 `send_wechat_image` MCP 工具发,否则接收方收到红叹号破损图(微信图片 CDN 上传按 MediaStore 解析文件)。`send_wechat_image` 工具已自动处理这步。 ## Endpoint ``` POST https://maas-openapi.wanjiedata.com/api/v1/images/generations ``` ## Request(正确格式,勿加 responseFormat) ```json { "model": "GPT Image 2", "prompt": "Your prompt text here...", "n": 1, "size": "1024x1024" } ``` ## Response ```json {"created":1234567890,"data":[{"b64_json":"iVBORw0K...(base64 PNG)"}],"usage":{...}} ``` 提取图片:`data[0].b64_json` → base64 decode → PNG(1024×1024,~1.5–2.3MB)。 ## curl(可直接跑) ```bash curl -s -X POST 'https://maas-openapi.wanjiedata.com/api/v1/images/generations' \ -H "Authorization: Bearer $WANJIE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{"model":"GPT Image 2","prompt":"A cute orange cat","n":1,"size":"1024x1024"}' \ | python3 -c "import sys,json,base64; d=json.load(sys.stdin); open('out.png','wb').write(base64.b64decode(d['data'][0]['b64_json'])); print('saved out.png')" ``` ## 端到端:生图 + 发微信(推荐流程) ```bash # 1. 生图 → 存到 /sdcard/Pictures/(媒体目录,微信可索引) curl -s -X POST 'https://maas-openapi.wanjiedata.com/api/v1/images/generations' \ -H "Authorization: Bearer $WANJIE_API_KEY" -H 'Content-Type: application/json' \ -d '{"model":"GPT Image 2","prompt":"<你的 prompt>","n":1,"size":"1024x1024"}' \ | python3 -c "import sys,json,base64;d=json.load(sys.stdin);open('/sdcard/Pictures/gen.png','wb').write(base64.b64decode(d['data'][0]['b64_json']))" # 2. 用 MCP 工具发(自动 stage 到 /sdcard/Pictures + media scan,避红叹号) # mcp_android_phone_send_wechat_image(to="", image_path="/sdcard/Pictures/gen.png") ``` ## Model Listing ```bash curl https://maas-openapi.wanjiedata.com/api/v1/models -H "Authorization: Bearer $WANJIE_API_KEY" # → 71 个模型,图像相关只有 "GPT Image 2"(+ hunyuan-vision,非文生图) ``` ## Key 配置(让 Hermes 自动用 GPT Image 2) - `$WANJIE_API_KEY` 已写进 `~/.bashrc` + `~/.profile` + `~/.hermes_env.sh`(BASH_ENV 兜底非交互子进程)。 - 从 Termux 交互 shell 跑 hermes 会自动带上;若某次子进程取不到,`source ~/.hermes_env.sh` 或检查 BASH_ENV。 - key 是 JWT,明文存 rc 文件;轮换 key 时改这三个文件。