图片生成接口

图片生成使用 OpenAI 风格的请求路径。实际模型由当前账号的分组和管理员启用的渠道决定，请先通过 /v1/models 或创作台确认可用模型名称。

生成一张图片

POST https://ohmytoken.cn/v1/images/generations

curl --request POST 'https://ohmytoken.cn/v1/images/generations' \
  --header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_IMAGE_MODEL",
    "prompt": "一座雨后的未来城市，清晨自然光，细节丰富，写实摄影风格",
    "size": "1024x1024",
    "n": 1
  }'

请把 YOUR_IMAGE_MODEL 替换为当前模型列表中的图片模型。某些部署中可能提供 gpt-image-2，但只有它出现在当前账号的模型列表时才能使用。

返回结果

不同上游可能返回临时图片 URL 或 Base64。客户端应兼容两种形式：

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

或者：

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

URL 可能有有效期，程序收到结果后应及时下载。Base64 内容需要解码后保存为图片文件。

生成多张图片

推荐始终发送 "n": 1。需要两张或更多图片时，重复请求，而不是把 n 改为 2 或更大。这样能兼容不支持单次多图的上游模型，也能让每次成功结果和计费独立对应。

以下示例生成两张：

for request_number in 1 2; do
  curl --request POST 'https://ohmytoken.cn/v1/images/generations' \
    --header "Authorization: Bearer ${OHMYTOKEN_API_KEY}" \
    --header 'Content-Type: application/json' \
    --data '{
      "model": "YOUR_IMAGE_MODEL",
      "prompt": "一座雨后的未来城市，清晨自然光，细节丰富，写实摄影风格",
      "size": "1024x1024",
      "n": 1
    }'
done

网页创作台选择 2 至 4 张时，已经自动采用这一策略。

常用参数

字段	类型	必填	说明
model	string	是	当前账号可用的图片模型
prompt	string	是	图片描述
size	string	否	例如 1024x1024，以模型支持范围为准
n	integer	否	推荐固定为 1
quality	string	否	质量选项，以模型支持范围为准
response_format	string	否	返回 URL 或 Base64 的偏好；上游可能忽略
background	string	否	背景选项，以模型支持范围为准
output_format	string	否	输出格式，以模型支持范围为准

不要盲目发送某个上游不支持的可选字段。最小请求只需要 model、prompt，建议先用最小请求验证模型，再逐项增加参数。