Skip to content
新知人工智能平台 新知人工智能平台

图片生成 API

图片生成 API

Section titled “图片生成 API”

本教程将介绍如何使用图片生成 API 来生成高质量的图片。

接口概览

Section titled “接口概览”
项目说明
路径/api/v3/images/generations
方法POST
Content-Typeapplication/json
认证方式Bearer Token（请求头 Authorization）
支持模式文生图、图生图、多图融合、多参考图生组图

调用地址

Section titled “调用地址”
环境Base URL
生产环境（网关）https://aifusion.newwtouch.com/ai

请求参数（Body）

Section titled “请求参数（Body）”

基础参数

Section titled “基础参数”
参数名类型必填说明
modelstring✅模型 ID，如 doubao-seedream-5-0-260128
promptstring✅文本提示词，描述想要生成的图像内容
sizestring图像尺寸，如 1024x1024、2K、2048x2048
response_formatstring返回格式：url（默认）/ b64_json
streamboolean是否流式输出，默认 false

高级参数

Section titled “高级参数”
参数名类型说明
seedinteger随机种子，用于复现结果
output_formatstring输出格式：png / jpeg / webp
watermarkboolean是否添加水印
imagestring/array参考图片 URL 或 Base64（图生图模式）
sequential_image_generationstring多图生成模式：disabled(默认) / auto
sequential_image_generation_optionsobject多图生成配置
guidance_scaledouble引导系数，控制生成自由度
optimize_promptboolean是否优化提示词
optimize_prompt_optionsobject提示词优化配置
toolsarray工具配置，如联网搜索

sequential_image_generation_options 结构

Section titled “sequential_image_generation_options 结构”
参数名类型说明
max_imagesinteger最大生成图片数

tools 数组项结构

Section titled “tools 数组项结构”
参数名类型说明
typestring工具类型，如 web_search

响应参数

Section titled “响应参数”

ImagesResponse 结构

Section titled “ImagesResponse 结构”
参数名类型说明
createdlong创建时间戳
dataarray生成的图片列表
modelstring实际使用的模型 ID
usageobject用量信息

data 数组项结构

Section titled “data 数组项结构”
参数名类型说明
urlstring图片 URL（response_format=url 时）
b64_jsonstring图片 Base64 编码（response_format=b64_json 时）
sizestring图片尺寸

usage 结构

Section titled “usage 结构”
参数名类型说明
generated_imagesinteger生成的图片数量
output_tokensinteger输出 token 数
total_tokensinteger总 token 数
tool_usageobject工具使用次数（联网搜索时）

五种模式请求示例

Section titled “五种模式请求示例”

示例 1：文生图

Section titled “示例 1：文生图”

根据文本描述生成图片。

{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富，眼部焦点锐利，景深较浅，具有 Vogue 杂志封面的美学风格，采用中画幅拍摄，工作室灯光效果强烈。",
  "size": "2K",
  "output_format": "png",
  "watermark": false
}

响应示例：

{
  "model": "doubao-seedream-5-0-260128",
  "created": 1757321139,
  "data": [
    {
      "url": "https://...",
      "size": "3104x1312"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16280,
    "total_tokens": 16280
  }
}

示例 2：图生图

Section titled “示例 2：图生图”

基于参考图片生成新图片。

{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "保持模特姿势和液态服装的流动形状不变。将服装材质从银色金属改为完全透明的清水（或玻璃）。透过液态水流，可以看到模特的皮肤细节。光影从反射变为折射。",
  "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png",
  "size": "2K",
  "output_format": "png",
  "watermark": false
}

响应示例：

{
  "model": "doubao-seedream-5-0-260128",
  "created": 1757323224,
  "data": [
    {
      "url": "https://...",
      "size": "1760x2368"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16280,
    "total_tokens": 16280
  }
}

示例 3：多图融合

Section titled “示例 3：多图融合”

将多张参考图片融合生成新图片。

{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "将图 1 的服装换为图 2 的服装",
  "image": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imagesToimage_2.png"
  ],
  "sequential_image_generation": "disabled",
  "size": "2K",
  "output_format": "png",
  "watermark": false
}

响应示例：

{
  "model": "doubao-seedream-5-0-260128",
  "created": 1757323224,
  "data": [
    {
      "url": "https://...",
      "size": "1760x2368"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16280,
    "total_tokens": 16280
  }
}

示例 4：多参考图生组图

Section titled “示例 4：多参考图生组图”

基于多张参考图片，生成一组主题相关的图片。

{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "生成 3 张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上",
  "image": [
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png",
    "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"
  ],
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 3
  },
  "size": "2K",
  "output_format": "png",
  "watermark": false
}

响应示例：

{
  "model": "doubao-seedream-5-0-260128",
  "created": 1757388756,
  "data": [
    {
      "url": "https://...",
      "size": "2720x1536"
    },
    {
      "url": "https://...",
      "size": "2720x1536"
    },
    {
      "url": "https://...",
      "size": "2720x1536"
    }
  ],
  "usage": {
    "generated_images": 3,
    "output_tokens": 48960,
    "total_tokens": 48960
  }
}

示例 5：流式输出

Section titled “示例 5：流式输出”

流式输出图片生成结果，适合生成多张图片时实时展示进度。

{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "参考图 1，生成四图片，图中人物分别带着墨镜，骑着摩托，带着帽子，拿着棒棒糖",
  "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimages_1.png",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 4
  },
  "size": "2K",
  "stream": true,
  "output_format": "png",
  "watermark": false
}

流式响应示例（SSE 格式）：

event: image_generation.partial_succeeded
data: {
  "type": "image_generation.partial_succeeded",
  "model": "doubao-seedream-5-0-260128",
  "created": 1757396757,
  "image_index": 0,
  "url": "https://...",
  "size": "2496x1664"
}


event: image_generation.partial_succeeded
data: {
  "type": "image_generation.partial_succeeded",
  "model": "doubao-seedream-5-0-260128",
  "created": 1757396785,
  "image_index": 1,
  "url": "https://...",
  "size": "2496x1664"
}


event: image_generation.partial_succeeded
data: {
  "type": "image_generation.partial_succeeded",
  "model": "doubao-seedream-5-0-260128",
  "created": 1757396825,
  "image_index": 2,
  "url": "https://...",
  "size": "2496x1664"
}


event: image_generation.completed
data: {
  "type": "image_generation.completed",
  "model": "doubao-seedream-5-0-260128",
  "created": 1757396825,
  "usage": {
    "generated_images": 3,
    "output_tokens": 48672,
    "total_tokens": 48672
  }
}


data: [DONE]

附加示例：联网搜索

Section titled “附加示例：联网搜索”

结合联网搜索能力，获取实时信息生成图片。

{
  "model": "doubao-seedream-5-0-260128",
  "prompt": "制作一张上海未来 5 日的天气预报图，采用现代扁平化插画风格，清晰展示每日天气、温度和穿搭建议。整体为横向排版，标题为"上海未来 5 日天气预报"，包含 5 个等宽的垂直卡片，从左到右依次排列。整体风格为现代、干净、友好的扁平化矢量插画风格，线条清晰，色彩柔和。",
  "size": "2048x2048",
  "tools": [
    {
      "type": "web_search"
    }
  ],
  "output_format": "png",
  "response_format": "url",
  "watermark": false
}

响应示例：

{
  "model": "doubao-seedream-5-0-260128",
  "created": 1757321139,
  "data": [
    {
      "url": "https://...",
      "size": "3104x1312"
    }
  ],
  "usage": {
    "generated_images": 1,
    "output_tokens": 16280,
    "total_tokens": 16280,
    "tool_usage": {
      "web_search": 1
    }
  }
}

curl 测试命令

Section titled “curl 测试命令”

文生图

Section titled “文生图”
Terminal window
curl -X POST "https://aifusion.newwtouch.com/ai/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "充满活力的特写编辑肖像，模特眼神犀利，头戴雕塑感帽子，色彩拼接丰富",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

图生图

Section titled “图生图”
Terminal window
curl -X POST "https://aifusion.newwtouch.com/ai/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "将服装材质从银色金属改为完全透明的清水",
    "image": "https://example.com/images/photo.jpg",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

多图融合

Section titled “多图融合”
Terminal window
curl -X POST "https://aifusion.newwtouch.com/ai/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "将图 1 的服装换为图 2 的服装",
    "image": ["https://example.com/images/ref1.jpg", "https://example.com/images/ref2.jpg"],
    "sequential_image_generation": "disabled",
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

多参考图生组图

Section titled “多参考图生组图”
Terminal window
curl -X POST "https://aifusion.newwtouch.com/ai/v3/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "生成 3 张不同时间段的风景图片",
    "image": ["https://example.com/images/ref1.jpg", "https://example.com/images/ref2.jpg"],
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
      "max_images": 3
    },
    "size": "2K",
    "output_format": "png",
    "watermark": false
  }'

注意事项

Section titled “注意事项”
  1. 接口对齐: 本接口的请求参数和响应参数与 Seedream 官方 API 完全对齐，可直接参考官方文档获取更详细的参数说明