gpt-image-2-api-format.md 3.34 KB

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)

{
  "model": "GPT Image 2",
  "prompt": "Your prompt text here...",
  "n": 1,
  "size": "1024x1024"
}

Response

{"created":1234567890,"data":[{"b64_json":"iVBORw0K...(base64 PNG)"}],"usage":{...}}

提取图片:data[0].b64_json → base64 decode → PNG(1024×1024,~1.5–2.3MB)。

curl(可直接跑)

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')"

端到端:生图 + 发微信(推荐流程)

# 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="<wxid>", image_path="/sdcard/Pictures/gen.png")

Model Listing

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 时改这三个文件。