跳到主要内容

图像生成

Images API 用于根据文本提示词生成图片。接口兼容 OpenAI /v1/images/generations。

当前公开模型列表未包含图像生成模型。若你的账号已开通图像模型，请将示例中的 <image_model> 替换为实际可用模型名称。

Endpoint​

POST http://121.40.161.178/v1/images/generations

请求示例​

curl http://121.40.161.178/v1/images/generations \
  -H "Authorization: Bearer $PINDUCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<image_model>",
    "prompt": "一张干净现代的云计算 API 控制台界面，浅色背景，专业产品摄影风格",
    "size": "1024x1024",
    "n": 1
  }'

常用参数​

参数类型说明
modelstring图像生成模型名称
promptstring图片描述
sizestring图片尺寸，例如 1024x1024
nnumber生成图片数量

响应示例​

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

生产注意事项​

  • 对用户输入的提示词做安全审核，避免违法、侵权或敏感内容。
  • 对图片生成请求设置频率限制和费用告警。
  • 不要长期依赖临时图片 URL，业务需要持久化时应下载后存入自有对象存储。
  • 对失败请求记录模型、尺寸、耗时和错误码，便于定位成本与稳定性问题。