图像生成
使用统一目录中支持图像能力的 Model ID 生成图片。
使用图像生成能力前,请在模型目录中确认所选模型支持的接口、尺寸、输出方式和计费单位。
请求端点
支持兼容图像生成接口的模型使用:
POST https://api.vergora.ai/v1/images/generations模型采用其他接口时,请遵循对应模型说明,不要直接复用本页请求。
请求示例
{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一幅简洁的城市晨景插画",
"size": "YOUR_SUPPORTED_SIZE"
}请求字段
| 字段 | 说明 |
|---|---|
model | 必须是支持图像生成的 Model ID |
prompt | 描述主体、场景、构图和期望效果 |
size | 使用所选模型支持的尺寸或比例 |
| 其他参数 | 数量、质量、参考图等参数只在模型明确支持时使用 |
读取结果
结果可能以图片地址、编码内容或任务状态返回,具体方式取决于模型接口:
- 检查响应状态和返回结构。
- 按接口说明读取图片或任务标识。
- 如果返回任务标识,使用该接口提供的查询方式检查状态。
- 保存请求或任务标识,便于排查失败和核对费用。
“请求已提交”不表示图片已经生成完成。
保存图片
将生成结果下载或保存到自己的存储中。临时地址的有效期和访问要求以实际响应说明为准。结果可能包含敏感访问参数,分享前应检查链接是否适合公开。
费用与重试
图像请求可能按张数、尺寸、质量或其他单位计费。以模型价目和请求记录为准。超时后先检查已有请求或任务状态,避免重复生成和重复费用。