生图 API 调用指南 (OpenAI 标准)

XIMI-API 图片生成（Image Generation）服务完全兼容 OpenAI 官方生图 API 标准。您可以使用任何 OpenAI 兼容 SDK、cURL 或自定义 HTTP 请求发起高清图片合成。

---

1. 接口基本信息

• HTTP 请求方法：POST
• 网关接口 URL：
  • 主节点 A：https://api.ximi-api.cc.cd/v1/images/generations
  • 备节点 B：https://api.ximi-pro.xyz/v1/images/generations
• 请求头 Header：
  • Authorization: Bearer YOUR_API_KEY
  • Content-Type: application/json

---

2. 请求参数全量表 (Request Body)

请求体为 JSON 格式，主要参数明细如下：

参数名	类型	必须	默认值 / 示例	说明
model	String	是	gpt-image-2	调用的生图模型名称（推荐 gpt-image-2 或 dall-e-3）
prompt	String	是	"生成一张简洁的蓝白色科技感抽象图片"	图片描述词，尽量详细说明主体、风格、材质和色彩
size	String	否	1024x1024	图片分辨率。如 1024x1024（方图）、1536x1536（2K）、2848x2048（4K）
n	Integer	否	1	生成图片数量（1 ~ 4）
quality	String	否	standard	画质质量：standard (标准画质) 或 high (高精超清)
response_format	String	否	b64_json	返回格式：b64_json（Base64编码数据，推荐）或 url（临时下载链接）

---

3. 响应 JSON 数据结构示例

格式 A：b64_json 响应模式 (默认推荐)

{
  "created": 1722000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

前端接收到 b64_json 后，可直接渲染为图片：

<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." alt="Generated Result" />

---

4. 多语言代码调用示例

4.1. cURL (Bash)

curl https://api.ximi-api.cc.cd/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "赛博朋克风未来城市夜景，高耸入云的霓虹大楼，雨后街道反射灯光",
    "size": "2848x2048",
    "n": 1,
    "quality": "standard",
    "response_format": "b64_json"
  }'

4.2. Python (OpenAI SDK)

import base64
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.ximi-api.cc.cd/v1"
)

response = client.images.generate(
    model="gpt-image-2",
    prompt="一幅日系极简风景画，蓝天白云与远山",
    size="1024x1024",
    n=1,
    response_format="b64_json"
)

b64_data = response.data[0].b64_json
image_bytes = base64.b64decode(b64_data)

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

print("图片生成成功并保存为 output_image.png！")

4.3. Node.js (JavaScript)

import OpenAI from 'openai';
import fs from 'fs';

const openai = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.ximi-api.cc.cd/v1',
});

async function generateImage() {
  const result = await openai.images.generate({
    model: 'gpt-image-2',
    prompt: '3D 玻璃质感全息冰蓝萌宠猫咪',
    size: '1024x1024',
    response_format: 'b64_json',
  });

  const b64Data = result.data[0].b64_json;
  const buffer = Buffer.from(b64Data, 'base64');
  fs.writeFileSync('cat.png', buffer);
  console.log('图片保存完成！');
}

generateImage();