豆包即梦 Seedream 多图融合 API 接口文档
📌 接口地址
text
https://www.dmxapi.cn/v1/images/generations📋 模型列表
doubao-seedream-4-0-250828
💻 Python 示例代码
python
"""
┌─────────────────────────────────────────────────────────────────┐
│ 豆包 Seedream 图生图 API 调用示例 - 多图融合方式 │
│ │
│ 功能说明：演示如何使用多图融合方式进行图生图（最多10张） │
│ 适用模型：doubao-seedream-4-0-250828 │
└─────────────────────────────────────────────────────────────────┘
"""
import os
import json
import requests
# ═══════════════════════════════════════════════════════════════════════════════
# 第一部分：DMX API 基础配置
# ═══════════════════════════════════════════════════════════════════════════════
# 【配置项 1】DMX API 密钥
# 说明：从环境变量获取 API Key，如果没有则使用默认值
# 建议：生产环境请务必使用环境变量，避免密钥泄露
ark_api_key = os.getenv("ARK_API_KEY") or "sk-********************************************"
# 【配置项 2】DMX API 端点
url = "https://www.dmxapi.cn/v1/images/generations"
# 【配置项 3】DMX API 请求头
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {ark_api_key}"
}
# ═══════════════════════════════════════════════════════════════════════════════
# 第二部分：DMX API 请求参数配置（多图融合示例）
# ═══════════════════════════════════════════════════════════════════════════════
data = {
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ▸ 基础配置
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
"model": "doubao-seedream-4-0-250828", # 使用的模型名称
# ────────────────────────────────────────────────────────────────────────
# 【参数】prompt - 图像生成提示词
# ────────────────────────────────────────────────────────────────────────
# • 功能：描述多张图片之间的融合关系和期望生成的图像效果
# • 建议长度：不超过 300 个汉字或 600 个英文单词
# • 提示：可以使用"图1"、"图2"等指代不同的输入图片
# • 注意事项：字数过多会导致信息分散，模型可能忽略细节
# ────────────────────────────────────────────────────────────────────────
"prompt": "将图1的服装换为图2的服装",
# ────────────────────────────────────────────────────────────────────────
# 【参数】image - 输入图片数组（多图融合方式）
# ────────────────────────────────────────────────────────────────────────
# • 功能：提供多张参考图片的 URL 地址，模型将融合这些图片生成新图像
# • 仅支持模型：doubao-seedream-4.0
# • 数量限制：最多支持 10 张图片
# • 支持格式：jpeg、png
# • 图片要求：
# - 宽高比（宽/高）范围：[1/3, 3]
# - 宽高长度（px）> 14
# - 文件大小：不超过 10MB
# - 总像素：不超过 6000×6000 px
# • 使用技巧：在 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_imagesToimage_2.png"
],
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ▸ 图像尺寸配置
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ────────────────────────────────────────────────────────────────────────
# 【参数】size - 图像尺寸设置（支持两种方式，不可混用）
# ────────────────────────────────────────────────────────────────────────
# 方式 1：指定分辨率（1K/2K/4K），模型根据 prompt 判断具体尺寸
# 方式 2：指定具体像素值（如 "2048x2048"）
#
# ┌───────────────────────────────────────────────────────────────────────┐
# │ doubao-seedream-4.0 推荐尺寸 │
# ├──────────┬────────────────┬─────────────────────────────────────────┤
# │ 宽高比 │ 推荐尺寸 │ 说明 │
# ├──────────┼────────────────┼─────────────────────────────────────────┤
# │ 1:1 │ 2048 x 2048 │ 标准正方形 │
# │ 4:3 │ 2304 x 1728 │ 传统横向照片 │
# │ 3:4 │ 1728 x 2304 │ 传统竖向照片 │
# │ 16:9 │ 2560 x 1440 │ 宽屏横向 │
# │ 9:16 │ 1440 x 2560 │ 宽屏竖向 │
# │ 3:2 │ 2496 x 1664 │ 35mm 胶片横向 │
# │ 2:3 │ 1664 x 2496 │ 35mm 胶片竖向 │
# │ 21:9 │ 3024 x 1296 │ 超宽屏 │
# └──────────┴────────────────┴─────────────────────────────────────────┘
# • 总像素范围：1280×720 ~ 4096×4096
# • 宽高比范围：1/16 ~ 16
# ────────────────────────────────────────────────────────────────────────
"size": "4K",
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ▸ 组图功能配置（仅 doubao-seedream-4.0 支持）
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# ────────────────────────────────────────────────────────────────────────
# 【参数】sequential_image_generation - 组图开关
# ────────────────────────────────────────────────────────────────────────
# • auto → 自动判断模式，模型根据提示词决定是否返回组图及数量
# • disabled → 关闭组图功能，仅生成单张图片
# ────────────────────────────────────────────────────────────────────────
"sequential_image_generation": "disabled"
}
# ═══════════════════════════════════════════════════════════════════════════════
# 第三部分：发送请求并处理响应
# ═══════════════════════════════════════════════════════════════════════════════
# 发送 POST 请求到 API
response = requests.post(url, headers=headers, json=data)
# ───────────────────────────────────────────────────────────────────────────────
# 输出响应信息
# ───────────────────────────────────────────────────────────────────────────────
print(f"状态码: {response.status_code}")
print(f"响应内容:\n{json.dumps(response.json(), indent=2, ensure_ascii=False)}")📤 返回示例
json
状态码: 200
响应内容:
{
"data": [
{
"url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-0/02176311548150626ff44d90c6057cfc4f6ecfe19e30ebff21435_0.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251114%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251114T101825Z&X-Tos-Expires=86400&X-Tos-Signature=aea63330eb1c219418ec9afa48ffd8c0bbf386bb937d0c148eeaa934d94e77d1&X-Tos-SignedHeaders=host"
}
],
"created": 1763115505,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 65536,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"output_tokens": 65536,
"claude_cache_creation_5_m_tokens": 0,
"claude_cache_creation_1_h_tokens": 0
}
}© 2025 DMXAPI · 豆包即梦多图融合接口