文生图模型：豆包即梦3 (seedream-3.0)

模型简介

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

API接口文档

基础信息

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

请求参数

参数名	类型	必填	说明
prompt	string	是	图像描述文本
model	string	是	模型名称(固定为"seedream-3.0")
size	string	是	图像尺寸(如"1664x936")
response_format	string	否	返回格式(默认"b64_json") ;也支持 url，把 \\u0026 替换成 &
seed	int	否	随机种子(-1表示随机)

尺寸比例参考

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

Python调用示例

import base64
import http.client
import json
import os
import time

# 配置API密钥(建议使用环境变量管理)
API_KEY = "sk-**********************************"
API_HOST = "www.dmxapi.cn"
ENDPOINT = "/v1/images/generations"

# 请求参数配置
params = {
    "prompt": "漫画风格的学习英文单词图：Hello",
    "model": "seedream-3.0",
    "size": "1664x936",  # 可自定义大小
    "n": 1, # 生成数量，但改了会报错
    "response_format": "b64_json",  # 输出方式，可以是 baase64，也可以是 url
    "seed": -1 #每次变随机种子
}

# 构建请求
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

try:
    # 建立HTTPS连接
    conn = http.client.HTTPSConnection(API_HOST)
    conn.request("POST", ENDPOINT, json.dumps(params), headers)
    
    # 处理响应
    res = conn.getresponse()
    if res.status == 200:
        data = json.loads(res.read())
        if data.get("data") and data["data"][0].get("b64_json"):
            # 解码并保存图片
            img_data = base64.b64decode(data["data"][0]["b64_json"])
            os.makedirs("output", exist_ok=True)
            filename = f"output/image_{time.strftime('%Y%m%d_%H%M%S')}.png"
            with open(filename, "wb") as f:
                f.write(img_data)
            print(f"图片保存成功: {filename}")
    else:
        print(f"请求失败: {res.status} {res.reason}")
        
except Exception as e:
    print(f"发生错误: {str(e)}")
finally:
    conn.close()

概念说明

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

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

2. 随机种子(seed)：

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

3. 安全注意事项：

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

错误处理

常见错误码：

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