JunFeiAI image-2 / GPT Image 2 API 使用文档

适用对象：需要通过 junfeiai.com 中转站调用图片生成模型的客户。

最后更新：2026-05-16

1. 接口概览

junfeiai.com 提供 OpenAI 兼容接口，调用方式与 OpenAI Image API 基本一致。客户只需要把官方 OpenAI 的 base_url 换成君飞 AI 的中转地址，并使用君飞 AI 后台生成的 API Key。

完整请求地址：

https://junfeiai.com/v1/images/generations
https://junfeiai.com/v1/images/edits

2. 准备 API Key

1. 登录 https://junfeiai.com
2. 进入控制台的 API Keys 页面
3. 创建或复制一个 API Key
4. 请求时放入 HTTP Header：

Authorization: Bearer sk-xxxx
Content-Type: application/json

注意：API Key 属于敏感凭证，不要放在前端网页、App 客户端、公开仓库或聊天截图里。

3. 文生图接口

请求

POST https://junfeiai.com/v1/images/generations
Authorization: Bearer <你的 API Key>
Content-Type: application/json

常用参数

建议客户生产环境先使用：

{
  "model": "gpt-image-2",
  "prompt": "请生成一张简洁高级的科技产品宣传图，白色背景，主体是一台银色智能音箱，柔和棚拍光线，商业摄影风格",
  "size": "1024x1024",
  "quality": "medium",
  "n": 1,
  "output_format": "png"
}

curl 示例

curl -X POST "https://junfeiai.com/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "请生成一张简洁高级的科技产品宣传图，白色背景，主体是一台银色智能音箱，柔和棚拍光线，商业摄影风格",
    "size": "1024x1024",
    "quality": "medium",
    "n": 1,
    "output_format": "png"
  }'

返回示例

{
  "created": 1778918400,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ],
  "output_format": "png",
  "quality": "medium",
  "size": "1024x1024"
}

返回图片在：

data[0].b64_json

这是 Base64 编码后的图片，需要解码后保存为文件。

4. Python 示例

安装依赖

pip install openai

生成图片并保存

from openai import OpenAI
import base64

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://junfeiai.com/v1",
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="请生成一张简洁高级的科技产品宣传图，白色背景，主体是一台银色智能音箱，柔和棚拍光线，商业摄影风格",
    size="1024x1024",
    quality="medium",
    n=1,
)

image_base64 = result.data[0].b64_json
image_bytes = base64.b64decode(image_base64)

with open("output.png", "wb") as f:
    f.write(image_bytes)

如果客户后台只显示 image-2，可把上面的：

model="gpt-image-2"

改为：

model="image-2"

5. Node.js 示例

安装依赖

npm install openai

生成图片并保存

import OpenAI from "openai";
import fs from "fs";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://junfeiai.com/v1",
});

const result = await client.images.generate({
  model: "gpt-image-2",
  prompt: "请生成一张简洁高级的科技产品宣传图，白色背景，主体是一台银色智能音箱，柔和棚拍光线，商业摄影风格",
  size: "1024x1024",
  quality: "medium",
  n: 1,
});

const imageBase64 = result.data[0].b64_json;
const imageBytes = Buffer.from(imageBase64, "base64");

fs.writeFileSync("output.png", imageBytes);

6. 图片编辑接口

图片编辑用于：上传一张或多张参考图，然后让模型按提示词重绘、改风格、替换局部区域或生成新版本。

请求

POST https://junfeiai.com/v1/images/edits
Authorization: Bearer <你的 API Key>
Content-Type: multipart/form-data

常用参数

curl 示例：参考图编辑

curl -X POST "https://junfeiai.com/v1/images/edits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@input.png" \
  -F "prompt=保留人物姿势和服装，把背景换成干净的白色摄影棚，商业大片质感" \
  -F "size=1024x1024" \
  -F "quality=medium"

curl 示例：局部遮罩编辑

curl -X POST "https://junfeiai.com/v1/images/edits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@input.png" \
  -F "mask=@mask.png" \
  -F "prompt=只替换遮罩区域，把桌子上的杯子换成一束鲜花，其他部分保持不变" \
  -F "size=1024x1024" \
  -F "quality=medium"

遮罩要求：

- mask 和原图尺寸一致 - mask 建议使用 PNG - 遮罩图需要包含 alpha 通道

7. 常见尺寸与质量建议

说明：

- quality=low 适合快速预览和批量试稿 - quality=medium 适合多数业务场景 - quality=high 适合最终交付图 - jpeg / webp 通常比 png 更适合追求速度和文件体积的场景 - 如需要透明背景，设置 background=transparent，同时使用 output_format=png 或 webp

8. 错误码排查

9. 最小可用测试

客户拿到 Key 后，可以先跑下面这个最小请求：

curl -X POST "https://junfeiai.com/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只白色陶瓷杯放在木桌上，自然光，真实摄影风格"
  }'

如果返回 JSON 中包含：

{
  "data": [
    {
      "b64_json": "..."
    }
  ]
}

说明调用成功。

10. 客户对接提醒

- 建议服务端调用，不建议浏览器前端直接调用，避免 API Key 泄露 - 图片生成可能需要几十秒，复杂提示词或高分辨率可能更久 - 客户系统应设置较长超时时间，建议不少于 120 秒 - 生产环境建议记录请求 ID、模型、尺寸、质量、调用时间和错误信息，方便排查 - 生成结果需符合平台内容政策，不建议生成侵权、违法、色情、暴力、仿冒证件等内容

11. 资料来源

- 君飞 AI 中转站：https://junfeiai.com - OpenAI GPT Image 2 模型说明：https://developers.openai.com/api/docs/models/gpt-image-2 - OpenAI 图片生成指南：https://developers.openai.com/api/docs/guides/image-generation - OpenAI Images API Reference：https://developers.openai.com/api/reference/resources/images