图片生成

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，即2048*2048，生成2K分辨率图像；

取值范围：[10241024, 40964096]，可生成1K到4K分辨率图像；

建议生成2k以上的图片，过小分辨率图片较大概率出现人脸效果不佳、文字异常等效果问题；若2K图片出图效果也不符合预期，可尝试输出更高分辨率图片

文生图场景

面积和宽高需要2选1传入，都不传则默认面积取“2048*2048”，即生成2K分辨率图像且模型智能判断宽高比；

面积和宽高同时输入时，优先使用宽高；

只传面积，模型会根据用户prompt意图智能判断生图宽高比

图生图场景：

结合用户prompt意图、参考图尺寸，由模型智能判断生图宽高比

width?integer

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

宽高乘积在[10241024, 40964096]，且宽高比在[min_ratio, max_ratio]之间

注意：需同时传width和height才会生效

推荐可选的宽高： 1K

1024x1024 （1:1）

2048x2048 （1:1）

2304x1728（4:3）

2496x1664 （3:2）

2560x1440 （16:9）

3024x1296 （21:9）

4096x4096 （1:1）

4694x3520（4:3）

4992x3328 （3:2）

5404x3040 （16:9）

6198x2656 （21:9）

height?integer

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

宽高乘积在[10241024, 40964096]，且宽高比在[min_ratio, max_ratio]之间

注意：需同时传width和height才会生效

force_single?boolean

是否强制生成单图

默认值：false

注意：

生成的组图越多，耗时越久，且生成耗时会随图片数量增多而显著变长；

如需稳定的组图输出效果，建议prompt控制组图数量在9张及以内；

生成组图时，建议prompt明确指明图片分辨率或直接传参具体宽高值，避免模型生成组图分辨率不一致导致接口报错；

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

req_key*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",
    "req_key": "string"
  }'

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",    "req_key": "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"
}

Header Parameters

Request Body

Response Body

200application/json

application/json