提交任务(Vega 格式)
Vega 图片生成采用异步任务:提交任务 → 轮询状态 → 下载图片。提交后立即返回任务 ID,不占用连接,适合批量提交、长时间生成、以及在任务队列里统一管理的场景。可用模型与最新价格以模型广场为准。
三个模型共用同一套端点与请求参数。文生图与图生图是同一个接口:不传 input 即为文生图,传了 input 即为图生图。
异步任务提交时先按 0 预扣,任务完成后按上游实际返回的用量结算(多退少补);任务失败不扣费。可随时在控制台「使用日志」核对。
生成耗时通常 20~100 秒(实测 Lite 约 19 秒、Pro 约 98 秒)。轮询建议预留 5 分钟以上,单次轮询请求超时设 30 秒即可,见查询与下载。
端点
POST /v1/tasks/vega
认证
请求头携带 Bearer 令牌(令牌获取见接入地址与鉴权):
请求体
本接口只处理上表字段,其余图片参数(如 response_format、quality、user)会被忽略。图片地址由查询与下载的 artifacts 接口给出,不需要 response_format。
文生图
只传 model + prompt(可带 size),即为文生图。
请求示例
响应体
提交成功立即返回任务对象,status 固定为 queued:
响应示例
图生图
同一个端点,额外用 input 传参考图,模型以参考图为基础整体重绘(改风格、改场景、保持构图主体等)。
input 字段
参考图数量上限
请求示例
注意事项
prompt必须包含「保持原图 / 原设计」等保留描述,否则模型会忽略参考图、按纯文生图处理。- 本地图片或不便于公开的图片,建议用
data:image/png;base64,...内联,见下方 WARNING。 - 单张参考图不超过 10MB,支持 PNG / JPEG。
- 参考图分辨率不影响输出尺寸(输出尺寸由
size决定)。
参考图是由上游服务去下载的,所以必须公网可达。实测使用墙外图床(如 Wikimedia)会拉取失败,任务以 502001 上游模型服务异常或不可达 结束。请改用可公网访问的地址,或直接内联 data:image/png;base64,...(推荐,最稳)。
计费
按上游实际返回的用量结算:提交时预扣 0,任务完成后按实际用量扣费,失败不扣费。单次生成的消耗随模型与参考图数量变化,实测(1024x1024,一张参考图)如下:
wand-vega-image-pro 图生图时,前 3 张参考图免费,第 4 张起每张多计 10,000 tokens。token 单价与最终金额以模型广场为准,实际扣费可在控制台「使用日志」核对。
错误码
更多错误码见错误码对照与排查。
原先的同步接口 POST /v1/images/generations 已不再支持 Vega 系列,请统一迁移到本页的异步接口;升级前的同步调用方式保留在旧版使用指南,仅作过渡参考。
提交成功后轮询任务状态并下载图片,见查询与下载。
