NewAPI 图像接口

gpt-image-2-low 文生图 API

通过 NewAPI 调用统一模型名称，使用标准 JSON 参数生成 1K 或 2K 图片。客户端无需处理号池模型后缀。

OpenAI 兼容 1K / 2K low / medium / high 4K 已禁用

POST https://api1.netwx.cn/v1/images/generations

鉴权客户端填写 NewAPI 用户密钥：Authorization: Bearer YOUR_NEWAPI_KEY。不要使用中转密钥或号池密钥。

快速开始

下面的请求会生成一张 1024 × 1024 图片。请将用户密钥替换为你的 NewAPI 用户令牌。

cURL

curl -X POST "https://api1.netwx.cn/v1/images/generations" \
  -H "Authorization: Bearer 你的NewAPI用户密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-low",
    "prompt": "一只坐在窗边的橘猫，柔和自然光，真实摄影风格",
    "size": "1024x1024",
    "quality": "low",
    "n": 1
  }'

模型名称 本页只适用于 gpt-image-2-low。它与支持 4K 的 gpt-image-2 是两个独立模型，请勿混用。

请求参数

请求体使用 JSON。尺寸可以直接写像素，也可以通过分辨率和比例字段组合指定。

参数	类型	必填	默认值	说明
`model`	string	是	-	固定填写 `gpt-image-2-low`
`prompt`	string	是	-	图片生成提示词
`size`	string	否	`1024x1024`	像素尺寸，也可以传 `1k` 或 `2k`
`quality`	string	否	`low`	`low`、`medium`、`high` 或 `auto`
`n`	integer	否	`1`	生成数量，多张支持情况取决于上游
`output_resolution`	string	否	`1k`	显式指定 `1k` 或 `2k`
`aspect_ratio`	string	否	`1:1`	显式指定图片比例，不支持 `auto`
`response_format`	string	否	上游决定	常见值为 `url` 或 `b64_json`
`user`	string	否	-	可选的终端用户标识

质量选项

low

medium

high

auto

auto 会回落到系统默认质量，通常为 low。

尺寸与比例

优先使用下表中的推荐尺寸。21:9 建议通过 output_resolution 与 aspect_ratio 明确指定。

比例	推荐尺寸	说明
1:1	`1024x1024`	方图
5:4	`1280x1024`	横向产品图
9:16	`576x1024`	竖屏内容
21:9	`1k` + `21:9`	使用显式参数
16:9	`1024x576`	横屏封面
4:3	`1024x768`	标准横图
3:2	`1536x1024`	摄影比例
4:5	`1024x1280`	竖向海报
3:4	`768x1024`	标准竖图
2:3	`1024x1536`	摄影竖图

比例	推荐尺寸	说明
1:1	`2048x2048`	2K 方图
5:4	`2560x2048`	横向产品图
9:16	`1152x2048`	2K 竖屏
21:9	`2k` + `21:9`	使用显式参数
16:9	`2048x1152`	2K 横屏
4:3	`2048x1536`	标准横图
3:2	`3072x2048`	摄影横图
4:5	`2048x2560`	竖向海报
3:4	`1536x2048`	标准竖图
2:3	`2048x3072`	摄影竖图

支持比例

1:1

5:4

9:16

21:9

16:9

4:3

3:2

4:5

3:4

2:3

4K 请求不会转发 4096x4096、size=4k 和 output_resolution=4k 都会直接返回 HTTP 400。

调用示例

示例生成一张 2K、16:9 的宽银幕图片，质量设置为 high。

cURL

curl -X POST "https://api1.netwx.cn/v1/images/generations" \
  -H "Authorization: Bearer 你的NewAPI用户密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-low",
    "prompt": "宽银幕电影感的雪山日出，云海，金色阳光，细节丰富",
    "output_resolution": "2k",
    "aspect_ratio": "16:9",
    "quality": "high",
    "n": 1
  }'

JavaScript

const response = await fetch(
  "https://api1.netwx.cn/v1/images/generations",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer 你的NewAPI用户密钥",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "gpt-image-2-low",
      prompt: "宽银幕电影感的雪山日出，云海，金色阳光",
      output_resolution: "2k",
      aspect_ratio: "16:9",
      quality: "high",
      n: 1
    })
  }
);

const result = await response.json();
if (!response.ok) {
  throw new Error(result.error?.message || "图片生成失败");
}

console.log(result.data[0].url);

Python

import requests

url = "https://api1.netwx.cn/v1/images/generations"
headers = {
    "Authorization": "Bearer 你的NewAPI用户密钥",
    "Content-Type": "application/json",
}
payload = {
    "model": "gpt-image-2-low",
    "prompt": "宽银幕电影感的雪山日出，云海，金色阳光",
    "output_resolution": "2k",
    "aspect_ratio": "16:9",
    "quality": "high",
    "n": 1,
}

response = requests.post(url, headers=headers, json=payload, timeout=300)
response.raise_for_status()
print(response.json()["data"][0]["url"])

响应格式

成功响应通常包含图片 URL。客户端应先检查 HTTP 状态，再读取 data[0].url。

JSON Response

{
  "created": 1784515242,
  "data": [
    {
      "url": "https://图片域名/generated/output.png"
    }
  ]
}

上游支持 Base64 时，数据字段可能改为 b64_json。

gpt-image-2-low 实际生成的水彩花瓶图片 — 真实接口输出示例 · 1024 × 1024

错误处理

错误响应使用统一的 error 对象。建议记录 HTTP 状态码、错误码和 message。

4K 拒绝响应

{
  "error": {
    "message": "4k size is disabled by this relay",
    "type": "invalid_request_error",
    "param": "size",
    "code": "size_not_allowed"
  }
}

HTTP 状态	含义	处理建议
`400`	参数错误、比例不支持或请求了 4K	检查 model、size、quality 和比例
`401`	NewAPI 用户密钥无效	检查 Authorization 请求头
`404`	接口路径或模型配置错误	确认使用 /v1/images/generations
`429`	请求频率过高或额度不足	降低并发或检查账户额度
`500`	服务端或号池异常	稍后重试并检查服务日志
`502 / 504`	上游不可用或生成超时	延长超时并检查反向代理

浏览器调用

前端网页建议通过同域名路径反代 NewAPI，例如网页与接口都使用 https://www.example.com。

JavaScript · 同源路径

const response = await fetch("/newapi/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer 你的NewAPI用户密钥",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-image-2-low",
    prompt: "一座漂浮在云层之上的未来城市",
    size: "2048x2048",
    quality: "high"
  })
});

HTTPS 图片地址 HTTPS 网页不能安全读取 HTTP 图片。接口返回的图片 URL 也应使用 HTTPS，否则浏览器可能以 Mixed Content 为由拦截。

前端密钥可见 写入网页 JavaScript 的固定密钥可以被访问者查看。正式业务应使用用户独立密钥、低额度密钥，或由自己的后端代为请求。

使用须知

客户端使用 NewAPI 用户密钥，不使用中转密钥或号池密钥。
请求模型名称必须与 NewAPI 中公开的模型名称完全一致。
size 已包含比例时，不要再传入与其冲突的 aspect_ratio。
size=auto 与 aspect_ratio=auto 均不受支持。
生成通常需要几十秒，客户端和反向代理超时建议设置为至少 300 秒。
返回图片可能具有有效期，重要结果应及时下载到自己的存储服务。