火山豆包即梦图生图 API 文档

📌 接口地址

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

🎨 支持模型

doubao-seedream-4-5-251128
doubao-seedream-4-0-250828
doubao-seededit-3-0-i2i-250628

💻 URL 生图 Python 示例代码

python

"""
┌─────────────────────────────────────────────────────────────────┐
│  豆包 Seedream 图生图 API 调用示例 - URL 方式                     │
│                                                                 │
│  功能说明：演示如何使用 URL 方式传入图片进行图生图                  │              
└─────────────────────────────────────────────────────────────────┘
"""

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-5-251128",  # 使用的模型名称

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】prompt - 图像生成提示词
    # ────────────────────────────────────────────────────────────────────────
    # • 功能：描述你希望基于输入图片生成的新图像内容
    # • 建议长度：不超过 300 个汉字或 600 个英文单词
    # • 注意事项：字数过多会导致信息分散，模型可能忽略细节
    # ────────────────────────────────────────────────────────────────────────
    "prompt": "生成狗狗趴在草地上的近景画面",

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】image - 输入图片（URL 方式）
    # ────────────────────────────────────────────────────────────────────────
    # • 功能：提供参考图片的 URL 地址，模型将基于此图片进行图像生成
    # • 支持格式：jpeg、png
    # • 图片要求：
    #   - 宽高比（宽/高）范围：[1/3, 3]
    #   - 宽高长度（px）> 14
    #   - 文件大小：不超过 10MB
    #   - 总像素：不超过 6000×6000 px
    # ────────────────────────────────────────────────────────────────────────
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.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": "2K",

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 组图功能配置（仅 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,

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】response_format - 返回格式
    # ────────────────────────────────────────────────────────────────────────
    # • url      → 返回图片下载链接（⚠️ 链接有效期：24小时，请及时下载）
    # • b64_json → 返回 Base64 编码的 JSON 格式图像数据
    # ────────────────────────────────────────────────────────────────────────
    "response_format": "url",

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】watermark - 水印设置
    # ────────────────────────────────────────────────────────────────────────
    # • False → 不添加水印
    # • True  → 在图片右下角添加"AI生成"字样水印标识
    # • ⚠️ 注意：此参数已被服务器强制设置为 False，修改不会生效
    # ────────────────────────────────────────────────────────────────────────
    "watermark": 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/021763112157214c761c9ca33f29b7756881c00fb9ff258fc098c_0.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251114%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251114T092247Z&X-Tos-Expires=86400&X-Tos-Signature=df2b93af2f9f1d65c3308c8e0445920ea658dd44486682fee3f6421630c80627&X-Tos-SignedHeaders=host"
    }
  ],
  "created": 1763112167,
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 15052,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "output_tokens": 15052,
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}

💻 Base64 生图 Python 示例代码

python

"""
┌─────────────────────────────────────────────────────────────────┐
│  豆包 Seedream 图生图 API 调用示例 - Base64 方式                  │
│                                                                 │
│  功能说明：演示如何使用 Base64 编码方式传入本地图片进行图生图       │
└─────────────────────────────────────────────────────────────────┘
"""

import os
import json
import requests
import base64

# ═══════════════════════════════════════════════════════════════════════════════
#  第一部分：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}"
}

# ═══════════════════════════════════════════════════════════════════════════════
#  第二部分：图片编码工具函数
# ═══════════════════════════════════════════════════════════════════════════════

def encode_image_to_base64(image_path):
    """
    将本地图片编码为 Base64 格式的 Data URI

    参数:
        image_path (str): 本地图片的文件路径

    返回:
        str: Base64 编码的 Data URI，格式为 "data:image/{格式};base64,{编码数据}"

    说明:
        • 支持格式：jpeg、png
        • 自动识别图片格式并添加正确的 MIME 类型
        • jpg 格式会自动转换为标准的 jpeg MIME 类型
    """
    with open(image_path, "rb") as image_file:
        # 读取图片文件并进行 Base64 编码
        encoded = base64.b64encode(image_file.read()).decode('utf-8')

        # 从文件扩展名获取图片格式
        ext = image_path.split('.')[-1].lower()

        # 将 jpg 统一转换为标准的 jpeg MIME 类型
        if ext == 'jpg':
            ext = 'jpeg'

        # 返回完整的 Data URI 格式
        return f"data:image/{ext};base64,{encoded}"

# ═══════════════════════════════════════════════════════════════════════════════
#  第三部分：DMX API 请求参数配置
# ═══════════════════════════════════════════════════════════════════════════════

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

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

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】prompt - 图像生成提示词
    # ────────────────────────────────────────────────────────────────────────
    # • 功能：描述你希望基于输入图片生成的新图像内容
    # • 建议长度：不超过 300 个汉字或 600 个英文单词
    # • 注意事项：字数过多会导致信息分散，模型可能忽略细节
    # ────────────────────────────────────────────────────────────────────────
    "prompt": "计算器在跳舞",

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】image - 输入图片（Base64 方式）
    # ────────────────────────────────────────────────────────────────────────
    # • 功能：提供本地图片的 Base64 编码，模型将基于此图片进行图像生成
    # • 支持格式：jpeg、png
    # • 图片要求：
    #   - 宽高比（宽/高）范围：[1/3, 3]
    #   - 宽高长度（px）> 14
    #   - 文件大小：不超过 10MB
    #   - 总像素：不超过 6000×6000 px
    # • 格式：data:image/{格式};base64,{编码数据}
    # ────────────────────────────────────────────────────────────────────────
    "image": encode_image_to_base64("test/example.jpg"),

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 图像尺寸配置
    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】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": "2K",

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 组图功能配置（仅 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,

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】response_format - 返回格式
    # ────────────────────────────────────────────────────────────────────────
    # • url      → 返回图片下载链接（⚠️ 链接有效期：24小时，请及时下载）
    # • b64_json → 返回 Base64 编码的 JSON 格式图像数据
    # ────────────────────────────────────────────────────────────────────────
    "response_format": "url",

    # ────────────────────────────────────────────────────────────────────────
    # 【参数】watermark - 水印设置
    # ────────────────────────────────────────────────────────────────────────
    # • False → 不添加水印
    # • True  → 在图片右下角添加"AI生成"字样水印标识
    # • ⚠️ 注意：此参数已被服务器强制设置为 False，修改不会生效
    # ────────────────────────────────────────────────────────────────────────
    "watermark": True,

    # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    # ▸ 提示词优化配置（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/021763113082954c761c9ca33f29b7756881c00fb9ff258f980e3_0.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20251114%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20251114T093830Z&X-Tos-Expires=86400&X-Tos-Signature=ad851d1b3fd804fc39bf00b13a80ee7964786e5883edc9c6547dbc74ffcd7b54&X-Tos-SignedHeaders=host"
    }
  ],
  "created": 1763113110,
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 15552,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "output_tokens": 15552,
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}

计费方式

-thinking思考功能的开关

openai绘图模型

豆包即梦绘图模型

Gemini绘图模型

gemini-3-pro-image-preview

gemini-2.5-flash-image

nano-banana-2

Flux绘图模型

Midjourney绘图模型

其他

豆包视频

MiniMax 海螺视频 Hailuo

Sora2视频模型

可灵官方 Kling

火山豆包即梦图生图 API 文档

📌 接口地址

🎨 支持模型

💻 URL 生图 Python 示例代码

📤 返回示例

💻 Base64 生图 Python 示例代码

📤 返回示例

gemini-3-pro-image-preview

gemini-2.5-flash-image

nano-banana-2

火山豆包 即梦 图生图 API 文档 ​

📌 接口地址 ​

🎨 支持模型 ​

💻 URL 生图 Python 示例代码 ​

📤 返回示例 ​

💻 Base64 生图 Python 示例代码 ​

📤 返回示例 ​

火山豆包即梦图生图 API 文档

📌 接口地址

🎨 支持模型

💻 URL 生图 Python 示例代码

📤 返回示例

💻 Base64 生图 Python 示例代码

📤 返回示例