20. 图片生成接口文档

API-16Z 支持通过 OpenAI 兼容接口生成 AI 图片。这个接口适合有开发能力的用户、机器人开发者、自动化脚本用户，以及想把图片生成接入自己工具的人。

20.1 可用模型与价格

模型	价格	说明
`gpt-image-2`	`0.60U/次`	最新图片模型，画质更好，适合正式出图
`gpt-image-1.5`	`0.30U/次`	性价比更高，适合测试、草图和日常生成

说明：

站内 1U 是 API-16Z 余额单位。
图片生成按“次数”扣费，不按普通文本 token 计算。
实际价格以 API-16Z 模型广场当前展示为准。
如果模型广场显示为 $0.60、$0.30，可以理解为分别消耗 0.60U、0.30U 站内额度。

20.2 接口信息

项目	内容
接口地址	`https://api16z.com/v1/images/generations`
请求方法	`POST`
认证方式	`Authorization: Bearer 你的API_KEY`
Content-Type	`application/json`

20.3 请求参数

参数	类型	必填	说明
`model`	string	是	`gpt-image-2` 或 `gpt-image-1.5`
`prompt`	string	是	图片描述，支持中文和英文
`size`	string	否	`1024x1024`、`1536x1024`、`1024x1536` 等，具体以模型支持为准
`n`	integer	否	生成数量，默认 `1`。新手建议先用 `1`

20.4 curl 请求示例

把 你的API_KEY 换成你自己的 API-16Z 密钥：

bash

curl -X POST https://api16z.com/v1/images/generations \
  -H "Authorization: Bearer 你的API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
    "size": "1024x1024",
    "n": 1
  }'

20.5 Python 请求示例

python

import base64
import requests

response = requests.post(
    "https://api16z.com/v1/images/generations",
    headers={
        "Authorization": "Bearer 你的API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
        "size": "1024x1024",
        "n": 1,
    },
)

data = response.json()
image_base64 = data["data"][0]["b64_json"]

with open("output.png", "wb") as f:
    f.write(base64.b64decode(image_base64))

print("图片已保存为 output.png")

20.6 Node.js 请求示例

javascript

const fs = require("fs");

async function generateImage() {
  const response = await fetch("https://api16z.com/v1/images/generations", {
    method: "POST",
    headers: {
      "Authorization": "Bearer 你的API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "gpt-image-2",
      prompt: "一只橘猫坐在窗台上看夕阳，水彩画风格",
      size: "1024x1024",
      n: 1,
    }),
  });

  const data = await response.json();
  const imageBase64 = data.data[0].b64_json;

  fs.writeFileSync("output.png", Buffer.from(imageBase64, "base64"));
  console.log("图片已保存为 output.png");
}

generateImage();

20.7 在客户端中使用

Cherry Studio、LobeChat、OpenCat 等客户端如果支持图片生成，可以这样配置：

字段	填写
API 地址 / Base URL	`https://api16z.com/v1`
API Key	你的 API-16Z 密钥
模型	`gpt-image-2` 或 `gpt-image-1.5`

如果客户端没有图片生成入口，只支持普通聊天，那就不能直接在该客户端里出图，需要用支持图片接口的软件、脚本或网页工具。

20.8 Prompt 写法建议

写好 prompt 可以明显提升图片质量。建议同时写清楚主体、风格、构图、光线和细节。

要素	示例
主体	一只橘猫、一个现代客厅、一座日本神社
风格	水彩画、油画、像素风、赛博朋克、建筑摄影
构图	特写、全景、俯视、侧面、居中构图
光线	夕阳光、柔和光、霓虹灯、自然光、电影感布光
细节	背景、颜色、材质、天气、镜头感

好的 prompt 示例：

text

一座日本神社被粉色樱花包围，水彩画风格，柔和的春日阳光，远处有富士山

text

一个现代简约风格的客厅，大落地窗，窗外是城市夜景，暖色灯光，建筑摄影风格

20.9 返回格式

常见返回格式如下：

json

{
  "data": [
    {
      "b64_json": "base64编码的图片数据..."
    }
  ]
}

部分客户端或上游可能返回图片 URL，而不是 b64_json。如果你写代码接入，建议同时兼容 b64_json 和 url 两种返回方式。

20.10 常见问题

Q: 生成一张图需要多久？ A: 通常 10-30 秒，取决于图片复杂度、模型状态和网络情况。

Q: 支持中文 prompt 吗？ A: 支持，中英文都可以。

Q: 为什么扣费不是 token？ A: 图片生成是按次数扣费，不按普通聊天 token 计费。

Q: 余额不足怎么办？ A: 优先联系原服务商续费或补额度；找不到原服务商时，联系官方客服 QQ：3984380868，微信/vx：API-16Z。

Q: 报 model not found 怎么办？ A: 检查模型名是否完整，例如 gpt-image-2 不要写错；同时确认你的令牌分组是否允许使用图片模型。