• 简体中文
  • 旧版使用指南(同步)

    WARNING

    同步接口 POST /v1/images/generations 已不再支持 Vega 系列:调用会返回 400 model ... tiered expr run failed。请改用新版异步任务接口(提交 → 轮询 → 下载,content_url 免令牌但有时效,需及时转存)。本页保留升级前的同步调用方式,仅作过渡参考。

    本页覆盖升级前通过同步接口使用 Vega 系列的两组玩法:文生图(Vega 特有字段与推荐分辨率)与图生图(input 传参考图)。可用模型与最新价格以模型广场为准。

    文生图(Vega 系列)

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

    三个模型共用同步端点 /v1/images/generations 与通用请求字段(见文生图与图生图),Vega 系列特有约定如下:

    字段说明
    prompt文本描述,最大 2000 字符
    size宽x高 格式,不同尺寸可能影响计费档位,推荐取值见下表
    n固定为 1,Vega 每次只生成一张图
    response_formaturl(默认,返回图片链接)或 b64_json(返回 Base64 编码)

    支持的常见分辨率(宽x高,与画面宽高比对应):

    宽高比推荐尺寸
    1:1(正方形)1024x1024
    16:9(横屏)1920x1080
    9:16(竖屏)1080x1920
    3:41536x2048
    4:32048x1536

    响应示例:

    {
      "created": 1790583910,
      "data": [
        {
          "url": "http://data-shanghai-xxx.cos.ap-shanghai.myqcloud.com/output/wand-vega/xxx.png"
        }
      ],
      "usage": {
        "prompt_tokens": 13500,
        "completion_tokens": 0,
        "total_tokens": 13500
      }
    }
    NOTE

    Vega 按次计费(文生图一次约消耗 13,500 tokens),usage.total_tokens 可用于计费对账;data[].url 为带签名的下载地址,有效期 7 天,请及时下载转存。

    图生图(Vega 系列)

    同一同步端点,通过 extra_body 透传 Vega 原生 input 字段传入参考图,支持多张参考图(仅传 prompt、不传 input 时即为普通文生图):

    字段类型必填说明
    inputarray[object]是多模态输入数组,每项的 content 为参考图列表
    input[].content[]array[object]是单个参考图写法:{"type": "input_image", "image_url": "..."}
    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 张起额外计费)

    Vega 系列图生图注意事项:

    • prompt 必须包含「保留原图 / 原设计」等描述,否则模型会忽略参考图、按纯文生图处理
    • n 固定为 1,每次只生成一张
    • 参考图分辨率不影响输出尺寸(由 size 决定),单张不超过 10MB,支持 PNG / JPEG
    • 计费按次统计,图生图额外消耗与参考图数量相关:pro 前 3 张参考图免费,第 4 张起每张额外消耗约 10,000 tokens
    cURL
    Python (openai)
    Node.js (openai)
    curl -X POST https://api-model.shuntianchuang.cn/v1/images/generations \
      -H "Authorization: Bearer sk-你的令牌" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "wand-vega-image-lite",
        "prompt": "keep this design exactly, add 3D glass crystal texture",
        "size": "1024x1024",
        "n": 1,
        "input": [{
          "content": [
            {"type": "input_image", "image_url": "https://xxx/参考图.png"}
          ]
        }]
      }'