DMXAPI

Appearance

豆包即梦 Seedream 多图融合 API 接口文档 ​

📌 接口地址 ​

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

📋 模型列表 ​

  • doubao-seedream-4-5-251128
  • 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"{ark_api_key}"
}

# ═══════════════════════════════════════════════════════════════════════════════
#  第二部分：DMX API 请求参数配置（多图融合示例）
# ═══════════════════════════════════════════════════════════════════════════════

data = {
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 基础配置
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

    "model": "doubao-seedream-4-5-251128",  # 使用的模型名称

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】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：指定分辨率（2K/4K），模型根据 prompt 判断具体尺寸
    # 方式 2：指定具体像素值（如 "2048x2048"）
    #
    # ┌───────────────────────────────────────────────────────────────────────┐
    # │ doubao-seedream-4.5 推荐尺寸                                          │
    # ├──────────┬────────────────┬─────────────────────────────────────────┤
    # │ 宽高比   │ 推荐尺寸       │ 说明                                    │
    # ├──────────┼────────────────┼─────────────────────────────────────────┤
    # │  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   │ 超宽屏                                  │
    # └──────────┴────────────────┴─────────────────────────────────────────┘
    # • 总像素范围：2560×1440=3686400 ~ 4096×4096=16777216
    # • 宽高比范围：1/16 ~ 16
    # • ⚠️ 注意：方式 2 需同时满足总像素和宽高比的取值范围
    #
    # 有效示例：3750x1250
    #   → 总像素 3750×1250=4687500，符合 [3686400, 16777216]
    #   → 宽高比 3750/1250=3，符合 [1/16, 16]
    #
    # 无效示例：1500x1500
    #   → 总像素 1500×1500=2250000，未达到 3686400 的最低要求
    #   → 虽然宽高比符合要求，但因未同时满足两项限制，故无效
    #
    # ┌───────────────────────────────────────────────────────────────────────┐
    # │ 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=921600 ~ 4096×4096=16777216
    # • 宽高比范围：1/16 ~ 16
    # • ⚠️ 注意：方式 2 需同时满足总像素和宽高比的取值范围
    #
    # 有效示例：1600x600
    #   → 总像素 1600×600=960000，符合 [921600, 16777216]
    #   → 宽高比 1600/600=8/3，符合 [1/16, 16]
    #
    # 无效示例：800x800
    #   → 总像素 800×800=640000，未达到 921600 的最低要求
    #   → 虽然宽高比符合要求，但因未同时满足两项限制，故无效
    # ────────────────────────────────────────────────────────────────────────
    "size": "4K",

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 组图功能配置（仅 doubao-seedream-4.5、doubao-seedream-4.0 支持）
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】sequential_image_generation - 组图功能开关
    # ────────────────────────────────────────────────────────────────────────
    # • 功能：控制是否关闭组图功能
    # • 组图：基于您输入的内容，生成的一组内容关联的图片
    # • 默认值：disabled
    # • 可选值：
    #   - auto     → 自动判断模式，模型根据提示词自主判断是否返回组图及图片数量
    #   - disabled → 关闭组图功能，模型只会生成一张图
    # ────────────────────────────────────────────────────────────────────────
    # "sequential_image_generation": "disabled",

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】sequential_image_generation_options - 组图功能配置（可选）
    # ────────────────────────────────────────────────────────────────────────
    # • 说明：仅当 sequential_image_generation 为 auto 时生效
    # • max_images：指定本次请求最多可生成的图片数量
    #   - 默认值：15
    #   - 取值范围：[1, 15]
    #   - ⚠️ 注意：输入的参考图数量 + 生成的图片数量 ≤ 15张
    # ────────────────────────────────────────────────────────────────────────
    # "sequential_image_generation_options": {
    #     "max_images": 15
    # },

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 输出配置
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】stream - 流式输出模式（doubao-seedream-4.5、doubao-seedream-4.0 支持）
    # ────────────────────────────────────────────────────────────────────────
    # • 默认值：False
    # • False → 非流式模式，等待所有图片生成完毕后一次性返回
    # • True  → 流式模式，每张图片生成后立即返回（适用于单图和组图）
    # ────────────────────────────────────────────────────────────────────────
    # "stream": False,

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 提示词优化配置（doubao-seedream-4.5、doubao-seedream-4.0 支持）
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】optimize_prompt_options - 提示词优化选项（可选）
    # ────────────────────────────────────────────────────────────────────────
    # • 说明：doubao-seedream-4.5 / 4.0 默认使用标准模式优化提示词
    # • mode：优化模式
    #   - standard → 标准模式：生成内容质量更高，耗时较长
    #   - fast     → 快速模式：生成内容耗时更短，质量一般
    # • ⚠️ 注意：doubao-seedream-4.5 当前仅支持 standard 模式
    # ────────────────────────────────────────────────────────────────────────
    # "optimize_prompt_options": {
    #     "mode": "standard"
    # }

}

# ═══════════════════════════════════════════════════════════════════════════════
#  第三部分：发送请求并处理响应
# ═══════════════════════════════════════════════════════════════════════════════

# 发送 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 · 豆包即梦多图融合接口

一个 Key 用全球大模型

Copyright © 2025 DMXAPI 版权所有