火山豆包 即梦3 & 即梦4 多图合并 API 文档

简介

seedream 是一个专注于从文本描述生成高质量图像的高效模型。它以较低的成本和快速的生成速度为特点，特别适合需要批量生成各类创意图片的场景。

豆包官方文档

即梦4：https://www.volcengine.com/docs/82379/1541523

模型名称

doubao-seedream-4-0-250828

seededit-3.0

基础信息

• Base URL: https://www.dmxapi.cn/v1/images/generations
• 请求方式: POST
• 认证方式: Bearer Token

请求参数

参数名	类型	必填	说明
prompt	string	是	图像描述文本
model	string	是	模型名称(固定为"seedream-3.0")
size	string	是	图像尺寸(如"1664x936")
response_format	string	否	返回格式(默认"b64_json") ;也支持 url，把 \\u0026 替换成 &
seed	int	否	随机种子(-1表示随机)

尺寸比例参考

1:1 → 1328x1328
16:9 → 1664x936
9:16 → 936x1664
3:4 → 1104x1472

Python调用示例

import json

import requests

API_URL = "https://www.dmxapi.cn/v1/images/generations"
API_KEY = "sk-****************************************"  # 改成你的 DMXAPI 令牌

payload = json.dumps(
    {
        "model": "doubao-seedream-4-0-250828",
        "prompt": "把DMXAPI的logo放在T恤上面",
        "image": [
            "https://dmxapi.com/img/yifu.png",
            "https://dmxapi.com/DMXAPI-Banner.png",
        ],
    }
)
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

response = requests.request("POST", API_URL, headers=headers, data=payload)

## 结果里 包含图片的URL,URL需要转义，把 \\u0026 替换成 &
response_text = response.text.replace("\\u0026", "&")

print(response.text)

注意

返回结果里的 url 需要转义， 把 \\u0026 替换成 & 即可正常访问。

返回示例

{
  "data":[
    {
      "url":"https://......."   # 图片结果 URL
    }],
  "created":1757584136,
  "usage":{
    "prompt_tokens":0,
    "completion_tokens":0,
    "total_tokens":16384,
    "prompt_tokens_details":{
      "cached_tokens_details":{
      }
    },
    "completion_tokens_details":{
    },
    "output_tokens":16384
  }
}