图像生成

POST /v1/images/generations

AI 文生图接口，返回图片 URL 或 base64 编码（由 response_format 决定）。

请求参数

参数	类型	必填	说明
model	string	✅	图像模型，如 dall-e-3、gpt-image-1
prompt	string	✅	图片描述提示词
n	integer	—	生成张数（默认 1）
size	string	—	图片尺寸，如 1024x1024、1792x1024、1024x1792
quality	string	—	质量档位（视模型而定，如 standard / hd）
style	string	—	风格（vivid / natural，仅 DALL·E 3）
response_format	string	—	url（默认）或 b64_json

文生图示例

cURL

curl https://api.idreame.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "dall-e-3",
    "prompt": "极光下漂浮的玻璃终端，赛博朋克风格，高细节",
    "size": "1024x1024",
    "quality": "hd",
    "n": 1
  }'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.idreame.com/v1",
    api_key="sk-xxxxxxxx",
)

response = client.images.generate(
    model="dall-e-3",
    prompt="极光下漂浮的玻璃终端，赛博朋克风格，高细节",
    size="1024x1024",
    quality="hd",
    n=1,
)

print(response.data[0].url)

响应示例

{
  "created": 1752600000,
  "data": [
    {
      "url": "https://cdn.idreame.com/images/xxx.png",
      "revised_prompt": "A glass terminal floating in aurora light..."
    }
  ]
}

TIP

revised_prompt 是模型对你原始提示词的优化版本（仅 DALL·E 3），反映了实际用于生成的提示词内容。

图像编辑（图生图）

POST /v1/images/edits

上传原图和蒙版，根据提示词对指定区域进行修改。使用 multipart/form-data 格式：

curl https://api.idreame.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -F "image=@original.png" \
  -F "mask=@mask.png" \
  -F "model=dall-e-2" \
  -F "prompt=将背景替换为星空" \
  -F "n=1" \
  -F "size=1024x1024"

参数	说明
image	原图文件（PNG，最大 4MB，需有 alpha 通道）
mask	蒙版文件（PNG，白色区域为需要编辑的区域）
prompt	编辑指令描述

尺寸参考

模型	支持尺寸
DALL·E 3	1024x1024、1792x1024、1024x1792
DALL·E 2	256x256、512x512、1024x1024
gpt-image-1	1024x1024、1536x1024、1024x1536、auto