Skip to main content
POST /v1/images/generations 发送 JSON,必需 model 和 prompt。从一张图片开始;尺寸、质量及返回格式必须与所选模型匹配。 成功时读取 data[].url 或 data[].b64_json。本参考描述同步响应;支持图片流的直连渠道需使用对应事件协议,任务插件不提供统一流式模式。等待超时后先检查日志,避免重复生成。 完整接入指南与可执行示例 Read in English

授权

Authorization
string
header
必填

模型调用 API Key,不是控制台登录凭据 / Model API key, not console login credentials

请求体

application/json
model
string
必填

当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint

示例:

"YOUR_MODEL_ID"

prompt
string
必填

任务描述;遵循模型的长度和内容要求 / Task description; follow model length and content requirements

n
integer

请求图片数,模型通常有更小限制;建议从 1 开始 / Requested image count; models usually impose a smaller limit; start with 1

必填范围: 1 <= x <= 128
size
string

模型支持的尺寸,使用 x 而不是 × / Model-supported size; use x rather than ×

quality
string

质量档位,由模型决定 / Quality setting determined by the model

response_format
string

url 或 b64_json,仅在模型支持时指定;有些模型固定返回 Base64 / url or b64_json when supported; some models always return Base64

output_format
string

输出编码,例如 png、jpeg、webp;需模型支持 / Output encoding such as png, jpeg, webp; requires model support

background
string

背景选项;透明背景需模型和编码支持 / Background option; transparency requires model and format support

响应

图片结果 / Image result

data
object[]
必填

检查每项的 url 或 b64_json,不能仅凭 HTTP 200 判断有图片 / Check url or b64_json in each item; HTTP 200 alone does not guarantee an image

created
integer

Unix 秒 / Unix seconds