Skip to content

图像(Images)

根据文本提示词生成图像。

当前可使用的图像模型取决于虚拟 Key 的模型权限,例如:

  • gpt-image-1.5
  • gpt-image-2

请求接口

http
POST https://api.nexusmodels.cn/v1/images/generations

请求头

http
Authorization: Bearer YOUR_NEXUSMODELS_API_KEY
Content-Type: application/json

请求参数

参数类型必填说明
modelstring图像生成模型名称
promptstring需要生成的图像描述
ninteger生成图像数量
sizestring图像尺寸,支持值由模型决定
qualitystring图像质量,支持值由模型决定
backgroundstring背景类型,例如透明或不透明
output_formatstring输出格式,例如 pngjpeg
response_formatstring返回 URL 或 Base64,取决于模型支持情况
userstring最终用户标识

请求示例

bash
curl -sS -X POST \
  'https://api.nexusmodels.cn/v1/images/generations' \
  -H 'Authorization: Bearer YOUR_NEXUSMODELS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "一座位于未来城市中的人工智能研究中心,现代建筑风格,蓝色灯光",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

URL 响应示例

json
{
  "created": 1788163200,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

Base64 响应示例

部分模型会直接返回 Base64 图像数据:

json
{
  "created": 1788163200,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ]
}

保存 Base64 图像

假设接口响应保存在 response.json

bash
jq -r '.data[0].b64_json' response.json \
  | base64 --decode \
  > generated-image.png

macOS 可以执行:

bash
jq -r '.data[0].b64_json' response.json \
  | base64 -D \
  > generated-image.png