豆包即梦3 seededit-3.0 网络图片编辑API接口文档

模型名称

seededit-3.0

API接口文档

豆包官方文档：https://www.volcengine.com/docs/82379/1548482#图片编辑

基础信息

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

请求参数

参数	类型	必填	说明
model	string	是	使用的模型名称
prompt	string	是	指导图像生成的文本描述
image	string	是	输入图像的URL地址
seed	int	否	随机种子(默认随机)
guidance_scale	float	否	提示词权重(默认5.5)
size	string	否	输出尺寸(默认"adaptive")
watermark	bool	否	是否添加水印(默认true)

尺寸比例参考

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

Python调用示例

import json

import requests

# API 的 URL 端点
url = "https://www.dmxapi.cn/v1/images/generations"
api_key = "sk-************************************"  # 改成你的 DMXAPI 令牌

# 设置请求头
# API Key 需要通过 'Authorization' 头以 'Bearer ' 的形式提供
headers = {"Content-Type": "application/json", "Authorization": f"Bearer {api_key}"}

# 构造请求的 JSON 数据体 (payload)
# 将原始代码中的参数一一对应放入
payload = {
    "model": "seededit-3.0",
    "prompt": "改成方块形状的泡泡",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seededit_i2i.jpeg",
    "seed": 123,
    "guidance_scale": 5.5,
    "size": "adaptive",
    "watermark": True,
}

try:
    # 发送 POST 请求
    response = requests.post(url, headers=headers, data=json.dumps(payload))

    # 检查响应状态码
    response.raise_for_status()  # 如果状态码不是 2xx，将抛出 HTTPError 异常

    # 解析 JSON 响应
    imagesResponse = response.json()

    # 打印返回结果中的图片URL
    # 注意：根据API返回的实际结构获取数据，这里假设结构与SDK返回的类似
    if imagesResponse and "data" in imagesResponse and len(imagesResponse["data"]) > 0:
        print(imagesResponse["data"][0]["url"])
    else:
        print("未能从响应中获取图片URL，请检查返回内容：")
        print(imagesResponse)

except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")
except KeyError as e:
    print(f"解析响应失败，找不到键: {e}")
    # 打印原始响应内容以供调试
    # print(response.text)

概念说明

1. Prompt工程：描述越详细，生成效果越好。建议包含：

   • 主体内容
   • 艺术风格
   • 色彩要求
   • 构图细节

2. 随机种子(seed)：

   • 固定seed可生成相同图片
   • -1表示每次随机生成

3. 安全注意事项：

   • API密钥需妥善保管
   • 建议设置调用频率限制
   • 生成内容需符合法律法规

错误处理

常见错误码：

• 401 - 认证失败
• 400 - 参数错误
• 429 - 请求过于频繁
• 500 - 服务器内部错误