Sign in

v1

latestOpenAPI 3.1.02026-07-2634132204.7 KB
Image

图片生成接口

基于文本提示生成AI图片的接口，支持多种图片生成模型和参数配置

post/images/generations

Request body

modelstring required

图片生成模型

promptstring required

文本提示

negative_promptstring

反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制

strengthnumber

以图生图引用图片的影响强度，取值范围[0, 1]，默认0.5

sizestring

图片尺寸，不同模型设置不同，详见模型尺寸表

aspect_ratiostring

图片宽高比，不同模型设置不同，详见模型尺寸表

ninteger

图片数量，默认为1

qualitystring

图片质量，可灵AI支持 std、pro 两个配置，OpenAI/智谱清言支持 standard、hd 两个配置，GPT Image支持 auto/low/medium/high 四个配置项

style_presetstring

风格预设，目前仅 stable image 支持该配置

response_format'url' | 'b64_json'

图片响应格式，支持 url/b64_json 两种格式，默认为url

output_format'png' | 'jpg' | 'webp'

图片输出格式，支持 png/jpg/webp 三种格式，默认为png

maskstring

图片遮罩，支持图片URL/Base64编码数据

watermarkboolean

是否添加AI生成水印，默认为false，仅部分模型支持

background'transparent' | 'opaque' | 'auto'

背景透明度，目前仅 gpt-image-1 支持该配置

asyncboolean

是否异步生成，默认false，即同步等待图片生成成功后返回生成结果，如果异步需要通过调用图片获取接口获取生成结果

retriesinteger

自动重试次数，默认0，表示失败不重试

Example request

{
  "model": "gpt-image-1",
  "prompt": "画一只可爱的小猫",
  "style_preset": "3d-model"
}

Response

成功响应

task_idstring uuid

图片生成任务ID

task_status'pending' | 'running' | 'succeed' | 'failed'

任务状态

createdinteger required

创建时间戳

Example response

{
  "task_status": "running"
}