典名词元典名词元首页
API 文档
AI 模型接口图像即梦

图片生成

POST
/api/v1/image/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Region*string

固定值:Region为cn-north-1

Service*string

固定值:Service为cv

Request Body

application/json

image_urls?array<string>

图片文件URL,支持输入0至10张图 图片数量越多&图片尺寸越大,整体服务处理时间越长 输入图片建议控制在6张图片以内,图片过多,参考效果会降低

prompt*string

用于生成图像的提示词,中英文输入均可 。建议: 最长不超过800字符,prompt过长有概率出图异常或不生效 支持 prompt中直接指定生图比例,模型会根据“size”字段智能判断生图宽高比,默认生成2K分辨率、宽高比不超过3的图像; 除“”外不建议输入特殊的符号如$

scale?number

文本描述影响的程度,该值越大代表文本描述影响程度越大,且输入图片影响程度越小(精度:支持小数点后两位) 默认值:0.5 取值范围:[0, 1]

size?integer

生成图片的面积,默认值:4194304,即20482048,生成2K分辨率图像; 取值范围:[10241024, 4096*4096],可生成1K到4K分辨率图像; 建议生成2k以上的图片,过小分辨率图片较大概率出现人脸效果不佳、文字异常等效果问题;若2K图片出图效果也不符合预期,可尝试输出更高分辨率图片

width?integer

生成图像宽高,默认该字段不传

height?integer

生成图像宽高,默认该字段不传

force_single?boolean

force_single

min_ratio?number

生图结果的宽/高 ≥ min_ratio,如果智能选比例 < min_ratio,则用min_ratio 默认值:1/3 取值范围:[1/16,16)

max_ratio?number

生图结果的宽/高 ≤ max_ratio,如果智能选比例 > max_ratio,则用max_ratio 默认值:3 取值范围:[1/16,16)

callback_url?string

在使用异步回调时,回调接口URL(需公网可访问)

return_url?boolean

在使用异步回调时,设置图片资源是否以链接形式返回 (链接有效期为24小时) 默认值:false

logo_info?string

在使用异步回调时,设置水印信息

aigc_meta?string

在使用异步回调时,设置隐式标识

model*string

模型名称,固定值: jimeng_t2i_v40

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \  -H "Authorization: string" \  -H "Region: string" \  -H "Service: string" \  -H "Content-Type: application/json" \  -d '{    "prompt": "string",    "model": "string"  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}