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

简介

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

豆包官方文档

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

模型名称

doubao-seedream-4-0-250828

seededit-3.0

如何使用POST请求

请求方法

使用 POST 方法向以下端点发送请求：

请求URL

https://www.dmxapi.cn/v1/images/generations

请求头

Authorization: Bearer sk-*********************************
Content-Type: application/json

请求体格式

{
  "model": "doubao-seedream-4-0-250828",
  "prompt": "把DMXAPI的logo放在T恤上面",
  "image": [
    "https://dmxapi.com/img/yifu.png",
    "https://dmxapi.com/DMXAPI-Banner.png"
  ]
}

参数说明

• model: 使用的AI模型名称，支持 doubao-seedream-4-0-250828 和 seededit-3.0
• prompt: 图像生成的文本描述提示词
• image: 输入的图像URL数组，支持多张图片合并

Python调用示例

# 导入必要的库
import json  # 用于处理JSON数据
import urllib.parse  # 用于URL编码和解码
import requests  # 用于发送HTTP请求

# DMXAPI图像生成接口配置
API_URL = "https://www.dmxapi.cn/v1/images/generations"  # API接口地址
API_KEY = "sk-*********************************"  # 改成你的 DMXAPI 令牌

# 构建请求数据
payload = json.dumps(
    {
        "model": "doubao-seedream-4-0-250828",  # 使用的AI模型
        "prompt": "把DMXAPI的logo放在T恤上面",  # 图像生成提示词
        "image": [  # 输入的图像URL列表
            "https://dmxapi.com/img/yifu.png",  # T恤图片
            "https://dmxapi.com/DMXAPI-Banner.png",  # DMXAPI logo图片
        ],
    }
)

# 设置请求头
headers = {
    "Authorization": f"Bearer {API_KEY}",  # API认证令牌
    "Content-Type": "application/json",  # 请求内容类型
}

# 发送POST请求到API
response = requests.request("POST", API_URL, headers=headers, data=payload)

# 处理响应文本中的转义字符
# 结果里包含图片的URL，URL需要转义，把各种转义字符替换成正常字符
response_text = response.text.replace("\u0026", "&")  # 将Unicode转义的&符号替换为正常的&

# 解析JSON响应并处理URL解码
try:
    # 将响应文本解析为JSON对象
    response_data = json.loads(response_text)
    
    # 如果响应中包含data字段，处理其中的URL
    if "data" in response_data:
        for item in response_data["data"]:  # 遍历data数组中的每个项目
            if "url" in item:  # 如果项目包含url字段
                # 对URL进行完整的解码，处理URL编码字符
                decoded_url = urllib.parse.unquote(item["url"])
                item["url"] = decoded_url  # 更新为解码后的URL
    
    # 输出处理结果
    print("原始响应:")
    print(response.text)
    print("\n" + "="*50 + "\n")  # 分隔线
    print("处理后的响应:")
    # 输出格式化的JSON，确保中文字符正常显示
    print(json.dumps(response_data, indent=2, ensure_ascii=False))
    
except json.JSONDecodeError:
    # 如果JSON解析失败，输出原始响应内容
    print("JSON解析失败，输出原始响应:")
    print(response_text)