AIaitoearn
AI 服务/图像生成

异步生成图像

接口说明：异步生成图像，立即返回 logId，通过查询任务状态接口轮询结果。

调用本接口前，请先请求「图像生成模型」接口（GET /api/ai/models/image/generation），获取当前可用的模型列表及各模型支持的尺寸、质量、风格与价格，再据此填写本接口参数。

图像生成为文生图：仅通过文字提示词生成全新图像，不传入图片。如需基于已有图片进行修改（图生图），请使用「异步编辑图像」接口。

post/api/ai/image/generate/async

Request

Request body

promptstring required

图片描述提示

modelstring required

图像生成模型名称。先调用「图像生成模型」接口（GET /api/ai/models/image/generation），传入其返回的 data[n].name；各模型支持的尺寸、质量、风格与价格以该接口返回为准。

qualitystring

图像质量。可选值随模型而不同，以「图像生成模型」接口返回的 data[n].qualities 为准。

response_format'url' | 'b64_json'

返回格式

sizestring

图像尺寸。可选值随模型而不同，以「图像生成模型」接口返回的 data[n].sizes 为准；不同尺寸的价格不同，见 data[n].pricing。

stylestring

图像风格。可选值随模型而不同，以「图像生成模型」接口返回的 data[n].styles 为准；返回为空表示该模型不支持风格参数。

Example request

{
  "prompt": "A cute orange cat sitting by a window, soft natural light",
  "model": "gpt-image-2",
  "quality": "low",
  "response_format": "url",
  "size": "1024x1024"
}

Response

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

codeinteger required

业务状态码。0 表示成功，非 0 表示业务错误。

messagestring required

响应消息。

requestIdstring

请求 ID。

timestampinteger

错误响应时间戳，Unix 毫秒。

Changes

No recorded changes to this operation across all 2 revisions of this API.