SeeDream 图片生成/编辑

API 端点： https://api2.laozhang.ai/v1/images/generations可用模型：

seedream-4-0-250828 - $0.035/图
seedream-4-5-251128 - $0.045/图（最新版本）

计费方式： 按次计费

价格调整通知（2026年1月）官方补贴已结束，SeeDream 价格已调整：

SeeDream 4.0：$0.025/图 → $0.035/图
SeeDream 4.5（新版本）：$0.045/图

前置要求

获取 API Key

配置计费模式

编辑令牌设置，选择以下任一计费模式（两者价格相同）：

按量优先（推荐）：优先使用余额计费，余额不足时自动切换。适合大多数用户
按次计费：每次调用直接扣费。适合预算控制严格的场景

两种模式价格完全相同，仅扣费方式不同。SeeDream 4.0 为 $0.035/张，4.5 为 $0.045/张。

如果未设置计费模式，API调用会失败。必须先完成此配置！

更新日志

2025年9月11日 - SeeDream 4.0 API 官网上线，老张AI 当天接入并上线

核心特性

文生图

纯文字描述生成高质量图片

图改图

基于原图进行AI编辑和重绘

多图输入

最多支持 10 张参考图片

灵活尺寸

可自定义图片分辨率和尺寸

OpenAI 格式

完全兼容 OpenAI Image API 格式

灵活版本

4.0 版 $0.035/图，4.5 版 $0.045/图

重点信息

资源来源

战略合作伙伴SeeDream 4.0 源自 BytePlus 火山方舟的海外版，老张AI 已与其达成战略合作，为您提供稳定可靠的服务。

技术规格

项目	说明
API 格式	OpenAI Image API 兼容
请求端点	`/v1/images/generations`
模型名称	`seedream-4-0-250828` / `seedream-4-5-251128`
最大参考图	10 张
尺寸支持	可自定义分辨率
水印	可选关闭

版本与价格

版本	模型ID	价格	说明
SeeDream 4.0	`seedream-4-0-250828`	$0.035/图	稳定版本
SeeDream 4.5	`seedream-4-5-251128`	$0.045/图	最新版本，生成质量更高

💰 定价说明

SeeDream 4.0：$0.035/图
SeeDream 4.5：$0.045/图
扣费说明：按次计费，实际扣费可在调用日志中查看

准备工作

创建令牌

登录老张API令牌管理创建按次计费类型的令牌

选择计费方式

重要：必须选择”按次计费”类型

保存令牌

复制生成的令牌，格式为 sk-xxxxxx，在代码中替换 API_KEY

文生图 (Text to Image)

Python 版本

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
Seedream API 图片生成器 - 纯Python版本
修改 API_KEY 即可使用
"""

# =================== 配置区域 ===================
API_KEY = "sk-"                                              # 替换为您的API密钥
API_URL = "https://api2.laozhang.ai/v1/images/generations"    # API地址
PROMPT = "A beautiful sunset over mountains, realistic style"  # 图片描述
MODEL = "seedream-4-0-250828"                                # 模型名称
OUTPUT_DIR = "."                                             # 输出目录
# ==============================================

import requests
import os
import datetime

def generate_image(prompt, output_dir="."):
    """生成图片并保存到本地"""
    print(f"🎨 Seedream 图片生成器")
    print(f"📝 提示词: {prompt}")
    print("=" * 50)
    
    # API 请求参数
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}"
    }
    
    payload = {
        "model": MODEL,
        "prompt": prompt,
        "response_format": "url",
        "size": "2K",
        "watermark": False
    }
    
    try:
        print("⏳ 正在生成图片...")
        
        # 调用 API
        response = requests.post(API_URL, headers=headers, json=payload, timeout=60)
        
        if response.status_code != 200:
            return False, f"API错误 ({response.status_code}): {response.text}"
        
        # 解析响应
        result = response.json()
        if "data" not in result or len(result["data"]) == 0:
            return False, "API未返回图片数据"
        
        # 获取图片URL
        image_url = result["data"][0]["url"]
        print(f"🌐 获取图片URL成功")
        
        # 下载图片
        print("⬇️ 正在下载图片...")
        img_response = requests.get(image_url, timeout=30)
        img_response.raise_for_status()
        
        # 生成文件名（带时间戳）
        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
        filename = os.path.join(output_dir, f"generated_{timestamp}.jpg")
        
        # 保存图片
        os.makedirs(output_dir, exist_ok=True)
        with open(filename, 'wb') as f:
            f.write(img_response.content)
        
        file_size = len(img_response.content)
        return True, f"✅ 生成成功: {filename} ({file_size // 1024}KB)"
        
    except Exception as e:
        return False, f"生成失败: {str(e)}"

def main():
    """主函数"""
    print("🚀 Seedream API 图片生成器 - Python版本")
    print("=" * 50)
    
    # 检查 API 密钥
    if API_KEY == "sk-" or not API_KEY:
        print("⚠️  请先修改代码顶部的 API_KEY")
        print("   将 'sk-' 替换为您的真实API密钥")
        print()
        print("📋 使用说明:")
        print("1. 修改 API_KEY 为您的真实密钥")
        print("2. 可选：修改 PROMPT 生成不同内容的图片")
        print("3. 运行: python3 seedream-text-to-image.py")
        return
    
    # 执行图片生成
    success, message = generate_image(PROMPT, OUTPUT_DIR)
    print(message)
    
    if success:
        print()
        print("🎉 任务完成！")
        print("💡 提示：修改 PROMPT 可以生成不同内容的图片")

if __name__ == "__main__":
    main()

Curl 简单版本

curl -X POST https://api2.laozhang.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{
    "model": "seedream-4-0-250828",
    "prompt": "A beautiful sunset over mountains, realistic style",
    "response_format": "url",
    "size": "2K",
    "watermark": false
}'

Curl 一行版本（带自动下载）

需要安装 python3，会自动解析响应并下载图片

curl -X POST https://api2.laozhang.ai/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{"model": "seedream-4-0-250828","prompt": "A beautiful sunset over mountains, realistic style","response_format": "url","size": "2K","watermark": false}' \
  | python3 -c "import json,sys,os; data=json.loads(sys.stdin.read()); os.system(f'curl -L -o generated_\$(date +%Y%m%d_%H%M%S).jpg \"{data[\"data\"][0][\"url\"]}\"') if 'data' in data else print('Error')"

图改图 (Image to Image)

基于原图进行AI编辑和重绘，支持最多 10 张参考图。

Python 版本

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
Seedream API 图片编辑器 - Python版本
基于原图生成新图片，修改 API_KEY 即可使用
"""

# =================== 配置区域 ===================
API_KEY = "sk-"                                              # 替换为您的API密钥
API_URL = "https://api2.laozhang.ai/v1/images/generations"    # 图片编辑API地址
PROMPT = "Generate a close-up image of a dog lying on lush grass."  # 编辑提示词
IMAGE_URL = "https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seedream4_imageToimage.png"  # 原图URL
MODEL = "seedream-4-0-250828"                                # 使用的模型
OUTPUT_DIR = "."                                             # 输出目录
# ==============================================

import requests
import os
import datetime

def edit_image(prompt, image_url, output_dir="."):
    """基于原图生成编辑后的图片"""
    print(f"🎨 Seedream 图片编辑器")
    print(f"📝 编辑提示: {prompt}")
    print(f"🖼️  原图链接: {image_url[:50]}...")
    print("=" * 50)
    
    # API 请求参数
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {API_KEY}"
    }
    
    payload = {
        "model": MODEL,
        "prompt": prompt,
        "image": image_url,
        "sequential_image_generation": "disabled",
        "response_format": "url",
        "size": "2K",
        "stream": False,
        "watermark": False
    }
    
    try:
        print("⏳ 正在编辑图片...")
        
        # 调用 API
        response = requests.post(API_URL, headers=headers, json=payload, timeout=60)
        
        if response.status_code != 200:
            return False, f"API错误 ({response.status_code}): {response.text}"
        
        # 解析响应
        result = response.json()
        if "data" not in result or len(result["data"]) == 0:
            return False, "API未返回图片数据"
        
        # 获取图片URL
        edited_image_url = result["data"][0]["url"]
        print(f"🌐 获取编辑图片URL成功")
        
        # 下载图片
        print("⬇️ 正在下载编辑后的图片...")
        img_response = requests.get(edited_image_url, timeout=30)
        img_response.raise_for_status()
        
        # 生成文件名（带时间戳）
        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
        filename = os.path.join(output_dir, f"edited_{timestamp}.jpg")
        
        # 保存图片
        os.makedirs(output_dir, exist_ok=True)
        with open(filename, 'wb') as f:
            f.write(img_response.content)
        
        file_size = len(img_response.content)
        return True, f"✅ 编辑成功: {filename} ({file_size // 1024}KB)"
        
    except Exception as e:
        return False, f"编辑失败: {str(e)}"

def main():
    """主函数"""
    print("🚀 Seedream API 图片编辑器 - Python版本")
    print("=" * 50)
    
    # 检查 API 密钥
    if API_KEY == "sk-" or not API_KEY:
        print("⚠️  请先修改代码顶部的 API_KEY")
        print("   将 'sk-' 替换为您的真实API密钥")
        print()
        print("📋 使用说明:")
        print("1. 修改 API_KEY 为您的真实密钥")
        print("2. 修改 IMAGE_URL 为您要编辑的图片链接")
        print("3. 修改 PROMPT 描述您想要的编辑效果")
        print("4. 运行: python3 seedream-image-edit.py")
        return
    
    # 执行图片编辑
    success, message = edit_image(PROMPT, IMAGE_URL, OUTPUT_DIR)
    print(message)
    
    if success:
        print()
        print("🎉 编辑完成！")
        print("💡 提示：修改 PROMPT 和 IMAGE_URL 可以编辑不同的图片")

if __name__ == "__main__":
    main()

Curl 版本

#!/bin/bash

# Seedream API 图片编辑器 - Curl版本
# 基于原图生成新图片，修改 API_KEY 即可使用

# =============== 配置区域 ===============
API_KEY="sk-YOUR_API_KEY"                                    # 请替换为您的API密钥
API_URL="https://api2.laozhang.ai/v1/images/generations"      # 图片编辑API地址
PROMPT="Generate a close-up image of a dog lying on lush grass."  # 编辑提示词
IMAGE_URL="https://ark-doc.tos-ap-southeast-1.bytepluses.com/doc_image/seedream4_imageToimage.png"  # 原图URL
MODEL="seedream-4-0-250828"                                  # 模型名称
# ====================================

# 检查API密钥
if [ "$API_KEY" = "sk-YOUR_API_KEY" ]; then
    echo "⚠️  请先修改脚本中的 API_KEY"
    echo "   将 'sk-YOUR_API_KEY' 替换为您的真实API密钥"
    echo ""
    echo "📋 使用说明:"
    echo "1. 修改 API_KEY 为您的真实密钥"
    echo "2. 修改 IMAGE_URL 为您要编辑的图片链接"
    echo "3. 修改 PROMPT 描述您想要的编辑效果"
    echo "4. 运行: ./seedream-image-edit.sh"
    exit 1
fi

# 生成输出文件名
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
OUTPUT_FILE="edited_${TIMESTAMP}.jpg"

echo "🎨 Seedream API 图片编辑器 - Curl版本"
echo "========================================"
echo "📝 编辑提示: $PROMPT"
echo "🖼️  原图链接: ${IMAGE_URL:0:50}..."
echo "📁 输出文件: $OUTPUT_FILE"
echo "========================================"

# 步骤1: 调用API获取JSON响应
echo "⏳ 正在编辑图片..."

# 构建JSON请求体
JSON_DATA=$(cat <<EOF
{
  "model": "$MODEL",
  "prompt": "$PROMPT",
  "image": "$IMAGE_URL",
  "sequential_image_generation": "disabled",
  "response_format": "url",
  "size": "2K",
  "stream": false,
  "watermark": false
}
EOF
)

RESPONSE=$(curl -s -X POST "$API_URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d "$JSON_DATA")

# 检查API响应
if [ -z "$RESPONSE" ]; then
    echo "❌ API无响应，请检查网络连接"
    exit 1
fi

echo "✅ API响应成功"

# 步骤2: 使用Python解析JSON并提取图片URL
echo "🔍 解析编辑后的图片URL..."
EDITED_IMAGE_URL=$(echo "$RESPONSE" | python3 -c "
import json
import sys

try:
    data = json.loads(sys.stdin.read())
    
    if 'data' in data and len(data['data']) > 0:
        url = data['data'][0]['url']
        print(url)
    else:
        print('ERROR: 未找到图片URL')
        sys.exit(1)
        
except Exception as e:
    print(f'ERROR: {e}')
    sys.exit(1)
")

# 检查URL解析结果
if [[ "$EDITED_IMAGE_URL" == ERROR* ]]; then
    echo "❌ URL解析失败: $EDITED_IMAGE_URL"
    echo "📄 原始API响应:"
    echo "$RESPONSE"
    exit 1
fi

echo "🌐 编辑图片URL获取成功"

# 步骤3: 下载编辑后的图片
echo "⬇️ 正在下载编辑后的图片..."
curl -s -L -o "$OUTPUT_FILE" "$EDITED_IMAGE_URL"

# 检查下载结果
if [ -f "$OUTPUT_FILE" ] && [ -s "$OUTPUT_FILE" ]; then
    FILE_SIZE=$(du -h "$OUTPUT_FILE" | cut -f1)
    echo "✅ 图片编辑成功!"
    echo "📁 文件: $OUTPUT_FILE"
    echo "📊 大小: $FILE_SIZE"
    echo ""
    echo "🎉 完成! 请查看编辑后的图片文件"
    echo "💡 提示: 修改 PROMPT 和 IMAGE_URL 可以编辑不同的图片"
else
    echo "❌ 图片下载失败"
    echo "🔗 您可以手动访问: $EDITED_IMAGE_URL"
fi

API 开发文档

BytePlus ModelArk 官方技术文档

用户手册

Seedream 4.0 用户手册

用户指南

Seedream 4.0 使用指南

提示词技巧

提示词和风格关键词指南

常用边界问题

尺寸和分辨率

支持自定义图片尺寸，可通过 size 参数指定：

2K：2048像素（推荐）
也支持自定义分辨率

详见官方文档的参数说明。

参考图数量

文生图：无需参考图
图改图：支持 1-10 张参考图
通过 image 参数传入图片URL或Base64

水印设置

可通过 watermark 参数控制：

false：水印策略以模型返回为准（推荐）
true：带水印

响应格式

支持两种响应格式（response_format）：

url：返回图片链接（推荐，方便下载）
b64_json：返回Base64编码

生成模式

通过 sequential_image_generation 参数控制：

disabled：标准生成模式（推荐）
enabled：顺序生成模式

API 参数说明

请求参数

参数	类型	必需	说明
`model`	string	✓	模型名称：`seedream-4-0-250828`
`prompt`	string	✓	图片描述或编辑提示词
`image`	string	✗	参考图片URL（图改图时使用）
`size`	string	✗	图片尺寸，默认 `2K`
`response_format`	string	✗	响应格式：`url` 或 `b64_json`，默认 `url`
`watermark`	boolean	✗	是否添加水印，默认 `false`
`sequential_image_generation`	string	✗	生成模式，默认 `disabled`
`stream`	boolean	✗	是否流式响应，默认 `false`

响应格式

{
  "created": 1726051200,
  "data": [
    {
      "url": "https://example.com/generated_image.jpg",
      "revised_prompt": "..."
    }
  ]
}

下一步

Nano Banana 图片生成

$0.025/图的 Gemini 图片生成

FLUX 图片生成

查看 FLUX 图片生成 API

API 控制台

创建 API 令牌

账单与额度

查看余额、账户额度和调用日志

​前置要求

​更新日志

​核心特性

文生图

图改图

多图输入

灵活尺寸

OpenAI 格式

灵活版本

​重点信息

​资源来源

​技术规格

​版本与价格

​准备工作

​文生图 (Text to Image)

​Python 版本

​Curl 简单版本

​Curl 一行版本（带自动下载）

​图改图 (Image to Image)

​Python 版本

​Curl 版本

​相关资源

​官方文档

API 开发文档

用户手册

用户指南

提示词技巧

​常用边界问题

​API 参数说明

​请求参数

​响应格式

​下一步

Nano Banana 图片生成

FLUX 图片生成

API 控制台

账单与额度

前置要求

更新日志

核心特性

重点信息

资源来源

技术规格

版本与价格

准备工作

文生图 (Text to Image)

Python 版本

Curl 简单版本

Curl 一行版本（带自动下载）

图改图 (Image to Image)

Python 版本

Curl 版本

相关资源

官方文档

常用边界问题

API 参数说明

请求参数

响应格式

下一步