• 简体中文
  • 提交任务(Vega 格式)

    Vega 图片生成采用异步任务:提交任务 → 轮询状态 → 下载图片。提交后立即返回任务 ID,不占用连接,适合批量提交、长时间生成、以及在任务队列里统一管理的场景。可用模型与最新价格以模型广场为准。

    模型 ID说明
    wand-vega-image-liteVega 轻量版,性价比高
    wand-vega-image-flashVega 极速版,生成速度最快
    wand-vega-image-proVega 专业版,支持多参考图,质量最高
    TIP

    三个模型共用同一套端点与请求参数。文生图与图生图是同一个接口:不传 input 即为文生图,传了 input 即为图生图。

    NOTE

    异步任务提交时先按 0 预扣,任务完成后按上游实际返回的用量结算(多退少补);任务失败不扣费。可随时在控制台「使用日志」核对。

    WARNING

    生成耗时通常 20~100 秒(实测 Lite 约 19 秒、Pro 约 98 秒)。轮询建议预留 5 分钟以上,单次轮询请求超时设 30 秒即可,见查询与下载。

    端点

    POST /v1/tasks/vega

    认证

    请求头携带 Bearer 令牌(令牌获取见接入地址与鉴权):

    Authorization: Bearer sk-你的令牌

    请求体

    字段类型必填说明
    modelstring是图片模型名,取值见上方模型表
    promptstring文生图必填画面描述;图生图时为重绘描述,见图生图
    sizestring否图片尺寸,宽x高 格式,如 1024x1024;不传则用上游默认值
    ninteger否固定为 1,Vega 每次只生成一张图
    inputarray[object]图生图必填参考图数组,格式见图生图
    NOTE

    本接口只处理上表字段,其余图片参数(如 response_format、quality、user)会被忽略。图片地址由查询与下载的 artifacts 接口给出,不需要 response_format。

    文生图

    只传 model + prompt(可带 size),即为文生图。

    请求示例

    cURL
    Python
    Node.js
    curl https://api-model.shuntianchuang.cn/v1/tasks/vega \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "wand-vega-image-lite",
        "prompt": "一只戴耳机的橘猫在写代码,扁平插画风格",
        "size": "1024x1024",
        "n": 1
      }'

    响应体

    提交成功立即返回任务对象,status 固定为 queued:

    字段类型说明
    task_idstring任务 ID,后续查询与下载都用它
    idstring与 task_id 相同
    statusstring提交后固定为 queued
    modelstring本次请求使用的模型名
    created_atinteger任务创建时间(Unix 秒)

    响应示例

    {
      "created_at": 1791620512,
      "id": "task_c2eEf531tDsBj8t9hwcyFKlGu1tfZUXl",
      "model": "wand-vega-image-lite",
      "status": "queued",
      "task_id": "task_c2eEf531tDsBj8t9hwcyFKlGu1tfZUXl"
    }

    图生图

    同一个端点,额外用 input 传参考图,模型以参考图为基础整体重绘(改风格、改场景、保持构图主体等)。

    input 字段

    字段类型必填说明
    inputarray[object]是多模态输入数组,每项的 content 为参考图列表
    input[].content[]array[object]是单个参考图写法:{"type": "input_image", "image_url": "..."}
    input[].content[].typestring是固定为 input_image
    input[].content[].image_urlstring是参考图地址:公网 HTTP/HTTPS URL,或 data:image/png;base64,...(本地图片可转 Base64)

    参考图数量上限

    模型最大参考图数量
    wand-vega-image-lite3 张
    wand-vega-image-flash6 张
    wand-vega-image-pro6 张(第 4 张起额外计费)

    请求示例

    cURL
    Python
    Node.js
    curl https://api-model.shuntianchuang.cn/v1/tasks/vega \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-你的令牌" \
      -d '{
        "model": "wand-vega-image-pro",
        "prompt": "保持原设计,加 3D 玻璃水晶质感,浮在蓝色渐变背景上",
        "size": "1024x1024",
        "n": 1,
        "input": [
          {
            "content": [
              { "type": "input_image", "image_url": "https://你的图床/参考图.png" }
            ]
          }
        ]
      }'

    注意事项

    • prompt 必须包含「保持原图 / 原设计」等保留描述,否则模型会忽略参考图、按纯文生图处理。
    • 本地图片或不便于公开的图片,建议用 data:image/png;base64,... 内联,见下方 WARNING。
    • 单张参考图不超过 10MB,支持 PNG / JPEG。
    • 参考图分辨率不影响输出尺寸(输出尺寸由 size 决定)。
    WARNING

    参考图是由上游服务去下载的,所以必须公网可达。实测使用墙外图床(如 Wikimedia)会拉取失败,任务以 502001 上游模型服务异常或不可达 结束。请改用可公网访问的地址,或直接内联 data:image/png;base64,...(推荐,最稳)。

    计费

    按上游实际返回的用量结算:提交时预扣 0,任务完成后按实际用量扣费,失败不扣费。单次生成的消耗随模型与参考图数量变化,实测(1024x1024,一张参考图)如下:

    模型文生图图生图(1 张参考图)
    wand-vega-image-lite13,500 tokens13,500 tokens
    wand-vega-image-flash45,000 tokens45,000 tokens
    wand-vega-image-pro95,000 tokens95,000 tokens

    wand-vega-image-pro 图生图时,前 3 张参考图免费,第 4 张起每张多计 10,000 tokens。token 单价与最终金额以模型广场为准,实际扣费可在控制台「使用日志」核对。

    错误码

    HTTP错误信息说明
    401Invalid token令牌无效或缺失,检查 Authorization 头
    400model is required请求体缺少 model;模型名须取自上方模型表,否则无法路由到对应渠道
    400model ... tiered expr run failed用同步接口 POST /v1/images/generations 调 Vega 系列时出现(该路径已不支持 Vega),请改用本页异步接口
    502502001 上游模型服务异常或不可达上游瞬时故障,重试即可;图生图时优先检查参考图是否公网可达
    502Artifact upstream authentication failed图片地址已过期(content_url 的签名失效),拿不到图了;请重新生成,或改用自己转存后的副本

    更多错误码见错误码对照与排查。

    NOTE

    原先的同步接口 POST /v1/images/generations 已不再支持 Vega 系列,请统一迁移到本页的异步接口;升级前的同步调用方式保留在旧版使用指南,仅作过渡参考。

    提交成功后轮询任务状态并下载图片,见查询与下载。