• 简体中文
  • 文生图与图生图

    向 /v1/images/generations 发送文字描述生成图片(文生图),或传入参考图让模型以原图为基础整体重绘(图生图);doubao-seedream-5-0-pro 等模型还支持在该端点把参考图拆解为底图与独立图层(见下文「Seedream 图层拆分」)。图片模型多为按次计费,与 token 数无关,具体模型与单价以 模型广场 为准,下文以 qwen-image-2.0 为例。

    TIP
    • 局部编辑、蒙版涂抹请改用 图片编辑(/v1/images/edits,multipart 表单上传原图)
    • Vega 系列(wand-vega-image-*)已迁移至 Vega 异步任务接口,同步接口不再支持

    端点

    POST /v1/images/generations

    认证

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

    Authorization: Bearer sk-你的令牌

    请求体

    字段类型必填说明
    modelstring是图片模型名
    promptstring是画面描述
    sizestring否图片尺寸,如 1024x1024
    ninteger否生成张数,默认 1
    NOTE

    size 的取值与计费档位随模型而异:豆包 Seedream 系列用 2K、4K 等档位串,千问系列用 宽x高 格式(如 1024x1024),以 模型广场 各模型详情为准。

    文生图

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

    返回结果中每张图片有两种格式:

    • url:图片的下载链接,直接访问即可获取图片文件
    • b64_json:图片的 Base64 编码字符串,适合不便于外链下载的场景(请求时加 "response_format": "b64_json")

    图生图

    同一端点 /v1/images/generations,在请求中传入参考图,模型以原图为基础整体重绘(改风格、改场景、保持构图主体等)。需要上传本地原图或做局部涂抹编辑时,请改用 图片编辑。

    通用字段如下,参考图的传参方式与专属参数因厂商而异,请按所用模型选择下面对应的格式:

    字段类型必填说明
    modelstring是支持图生图的图片模型
    promptstring是重绘描述,建议明确写出「保持原图 / 原设计」等保留要求
    sizestring否输出尺寸,取值随模型而异
    response_formatstring否返回格式:url / b64_json
    TIP

    千问图生图模型(名称带 edit,如 qwen-image-edit-plus)不使用本节接口,请改用 图片编辑 的 /v1/images/edits(multipart 表单上传原图)。

    豆包 Seedream 格式

    doubao-seedream-4-5、doubao-seedream-5-0 等豆包 Seedream 系列模型,通过顶层 image 字段传入公网可访问的参考图 URL:

    字段类型必填说明
    modelstring是如 doubao-seedream-4-5
    promptstring是重绘描述,如「赛博朋克夜景,保持原图构图主体不变」
    imagestring / string[]是参考图 URL,doubao-seedream-5-0 支持多张,仅支持公网可访问链接,不支持本地文件
    sizestring否输出尺寸,如 2K,也可写 2048x2048;可选值随模型而异
    sequential_image_generationstring否Seedream 系列组图开关,图生图必须传 disabled,否则按组图模式生成;doubao-seedream-5-0 不支持该参数
    watermarkbool否是否添加水印
    NOTE

    上表字段组合以 doubao-seedream-4-5、doubao-seedream-5-0 实测为准;部分 Seedream 系列模型支持多张参考图,以 模型广场 模型详情与实际响应为准。

    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": "doubao-seedream-4-5",
        "prompt": "赛博朋克夜景,保持原图构图主体不变",
        "image": "https://xxx/参考图.png",
        "size": "2K",
        "sequential_image_generation": "disabled",
        "response_format": "url",
        "watermark": false
      }'

    Seedream 图层拆分

    doubao-seedream-5-0-pro 等支持图层拆分的模型,在同一端点通过顶层 layer_decomposition: true 输出底图 + 若干独立图层。请求必须传入且只传 1 张参考图:

    字段类型必填说明
    modelstring是支持图层拆分的模型,如 doubao-seedream-5-0-pro
    promptstring否拆分要求,可省略
    imagestring是参考图 URL,仅支持公网可访问链接,且必须恰好 1 张
    sizestring否1K / 1.5K / 2K / auto,默认 auto
    layer_decompositionbool是固定传 true
    response_formatstring否固定传 url
    watermarkbool否是否添加水印
    NOTE
    • 目前仅 doubao-seedream-5-0-pro、doubao-seedream-5-0-flash-260915 支持;4.5、5.0 lite、5.0 不支持
    • 输出底图 + 图层,最多 17 张,data 中每项一个 url
    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": "doubao-seedream-5-0-pro",
        "prompt": "把这张图拆成底图和独立图层",
        "size": "1.5K",
        "image": "https://xxx/参考图.png",
        "layer_decomposition": true,
        "response_format": "url",
        "watermark": false
      }'