ModelOne 模一万境

生成图像

在给定提示的情况下创建图像。

接口信息

  • 请求方式：POST
  • 请求地址：/v1/images/generations

认证方式

Bearer Token

请求头：Authorization: Bearer sk-xxxxxx

请求头

参数位置说明
AuthorizationHeaderBearer ，格式：Authorization: Bearer sk-xxxxxx

请求体

Content-Type：application/json

参数名类型是否必填说明
modelstring否用于图像生成的模型。可选：dall-e-2、dall-e-3、gpt-image-1；默认 dall-e-2
promptstring是所需图像的文本描述。
gpt-image-1：最大 32000 字符
dall-e-2：最大 1000 字符
dall-e-3：最大 4000 字符
ninteger否要生成的图像数量，取值范围1~10；dall-e-3 仅支持 n=1
sizestring否图像尺寸
gpt-image-1：1024x1024、1536x1024、1024x1536、auto
dall-e-2：256x256、512x512、1024x1024
dall-e-3：1024x1024、1792x1024、1024x1792
backgroundstring否仅 gpt-image-1 支持；可选 透明、不透明、自动；透明背景建议使用 png/webp 格式
moderationstring否仅 gpt-image-1 支持；内容审核级别：低、自动
qualitystring否图像质量参数
streamstring否是否开启流式返回
stylestring否图像风格参数
userstring否用户标识

响应信息

  • HTTP 200：application/json，返回图像结果

请求示例

curl "你的接口地址/v1/images/generations" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "山间溪流，春日森林，柔和自然光",
    "n": 1,
    "size": "1792x1024"
  }'