图片生成

Sprelay API 通过 POST /v1/images/generations 提供 OpenAI 兼容的图片生成接口。当前已实际验证 gpt-image-2、1024x1024、low 质量和 Base64 图片返回。

验证状态

本页示例已使用临时低额度密钥完成真实请求。图片编辑接口尚未验证，因此本页不包含 /v1/images/edits。

使用前准备

1. 在模型广场确认 gpt-image-2 当前可见。
2. 创建 API 密钥时选择“image-2生图专用”分组。
3. 为图片密钥设置单独额度，首次测试建议只生成 1 张低质量图片。
4. 将密钥保存到 SPRELAY_API_KEY 环境变量，不要写进脚本或前端代码。

模型、分组和价格会动态调整，实时信息以模型广场为准。

最小请求

# 请求图片生成端点，并把 JSON 响应保存到 response.json。
curl https://sprelaytoken.com/v1/images/generations \
  -H "Authorization: Bearer $SPRELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A simple flat blue circle centered on a white background.",
    "n": 1,
    "size": "1024x1024",
    "quality": "low"
  }' \
  --output response.json

prompt 描述画面，n: 1 只生成一张，size 和 quality 使用本页已验证组合。--output 保存响应，避免很长的 Base64 内容铺满终端。JSON 内不能写注释，修改时请保留语法。

成功响应的图片位于 data[0].b64_json。在支持 jq 和 base64 的环境中，可以解码为 PNG：

# jq 从 JSON 中取出 Base64 字符串，base64 再把它还原成 PNG 文件。
jq -r '.data[0].b64_json' response.json | base64 --decode > sprelay-image.png

Python 示例

# base64 负责解码图片，os 读取密钥，requests 发送 HTTP 请求。
import base64
import os

import requests

# timeout=180 给图片生成保留最多三分钟等待时间。
response = requests.post(
    "https://sprelaytoken.com/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SPRELAY_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "A simple flat blue circle centered on a white background.",
        "n": 1,
        "size": "1024x1024",
        "quality": "low",
    },
    timeout=180,
)
# 如果服务器返回 4xx/5xx，在解码前立刻抛出清晰错误。
response.raise_for_status()

# 读取 JSON，再取第一张图片的 Base64 字段。
payload = response.json()
image_bytes = base64.b64decode(payload["data"][0]["b64_json"])

# wb 表示以二进制方式写入 PNG 文件。
with open("sprelay-image.png", "wb") as image_file:
    image_file.write(image_bytes)

PowerShell 示例

# 请求头从当前 PowerShell 环境变量读取密钥。
$headers = @{
  Authorization = "Bearer $env:SPRELAY_API_KEY"
  "Content-Type" = "application/json"
}

# 生成 1 张 1024x1024 的低质量图片，先用低成本配置验证。
$body = @{
  model = "gpt-image-2"
  prompt = "A simple flat blue circle centered on a white background."
  n = 1
  size = "1024x1024"
  quality = "low"
} | ConvertTo-Json

# 调用接口并让 PowerShell 自动解析返回的 JSON。
$response = Invoke-RestMethod `
  -Uri "https://sprelaytoken.com/v1/images/generations" `
  -Method Post `
  -Headers $headers `
  -Body $body `
  -TimeoutSec 180

# 解码第一张图片，然后以二进制写入当前目录。
$bytes = [Convert]::FromBase64String($response.data[0].b64_json)
[IO.File]::WriteAllBytes("sprelay-image.png", $bytes)

返回中的 created 是生成时间，data 是图片数组，b64_json 是经过 Base64 编码的图片内容。示例中的短字符串只是省略展示，真实值会长很多。

已验证字段

字段	说明
model	必填；当前验证值为 gpt-image-2
prompt	必填；描述需要生成的画面
n	生成数量；首次调用使用 1 控制费用
size	当前验证值为 1024x1024
quality	当前验证值为 low

不要把其他模型的尺寸、质量或风格参数直接套用到 gpt-image-2。增加字段前先用最小请求确认当前线路支持。

返回格式

当前验证响应使用 Base64：

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

Base64 内容通常很大。生产环境应直接解码或存入对象存储，不要把完整内容写入日志、数据库文本列或错误上报。

费用与重试

• 使用专用低额度密钥隔离图片费用。
• 首次验证固定 n: 1 和 quality: low。
• 请求成功后到使用日志核对模型、分组和消费。
• 图片请求可能已经在上游执行；连接中断时不要立即无限重试，以免重复生成和重复计费。

常见错误

• 401：密钥缺失、格式错误或已被禁用。
• 403：密钥额度不足，或密钥分组不支持 gpt-image-2。
• 400：检查 prompt、n、size 和 quality。
• 429：降低并发并稍后重试。
• 5xx：查看使用日志确认请求是否已执行，再决定是否重试。