跳到主要内容

图像生成

使用 OpenAI 兼容的图像生成请求，根据文本提示词生成图片。

可用性​

前前公开模型列表以对话和文本模型为主。如果你的账号已开通图像模型，请在请求中使用对应模型 ID。

Endpoint​

POST https://pinducloud.cc/v1/images/generations

请求示例​

curl https://pinducloud.cc/v1/images/generations \
  -H "Authorization: Bearer $PINDUCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A clean product dashboard for an API platform, professional UI, light theme",
    "size": "1024x1024",
    "n": 1
  }'

响应示例​

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

参数​

参数类型必填说明
modelstring是已开通的图像模型 ID
promptstring是图像描述
sizestring否输出尺寸，例如 1024x1024
nnumber否生成图片数量

接入建议​

  • 将用户输入的提示词转发给图像模型前，应先做安全校验。
  • 如果需要长期访问生成图片，应将图片保存到自有对象存储。
  • 面向终端用户开放图像生成前，应配置成本告警和请求限制。