WaveSpeedAI Seedream V4.5 图像生成/编辑

通过 WaveSpeed AI 平台，使用字节跳动（ByteDance）的 Seedream V4.5 模型进行图像生成与编辑。支持最高达 4096×4096 的自定义分辨率，并针对海报与 Logo 中的文字渲染进行了增强排版优化，确保文字清晰锐利。

身份认证

export WAVESPEED_API_KEY="your-api-key"

请前往 wavespeed.ai/accesskey 获取您的 API 密钥。

快速开始

文生图（Text-to-Image）

import wavespeed from 'wavespeed';

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5",
  { prompt: "一个极简风格的咖啡馆 Logo，采用干净的字体排版" }
))["outputs"][0];

图像编辑（Image Editing）

images 参数接受一个图像 URL 数组（1–10 张图像）。若您使用本地文件，请先调用 wavespeed.upload() 上传以获取可访问的 URL。

import wavespeed from 'wavespeed';

// 上传本地图像以获取 URL
const imageUrl = await wavespeed.upload("/path/to/photo.png");

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5/edit",
  {
    images: [imageUrl],
    prompt: "添加温暖的日落光照效果及镜头光晕"
  }
))["outputs"][0];

您也可直接传入已有的图像 URL：

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5/edit",
  {
    images: ["https://example.com/photo.jpg"],
    prompt: "添加温暖的日落光照效果及镜头光晕"
  }
))["outputs"][0];

API 接口端点

文生图（Text-to-Image）

模型 ID：bytedance/seedream-v4.5

基于文本提示词生成图像，支持最高达 4096×4096 的自定义输出分辨率。

参数说明

示例

import wavespeed from 'wavespeed';

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5",
  {
    prompt: "一张科幻惊悚电影海报，顶部有加粗标题文字‘HORIZON’",
    size: "2048*3072"
  }
))["outputs"][0];

图像编辑（Image Editing）

模型 ID：bytedance/seedream-v4.5/edit

基于文本提示词对已有图像进行编辑，最多支持 10 张输入图像；在编辑过程中保留原始图像中的人脸特征、光照与色彩基调。

参数说明

示例

import wavespeed from 'wavespeed';

const imageUrl = await wavespeed.upload("/path/to/portrait.png");

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5/edit",
  {
    images: [imageUrl],
    prompt: "转换为鲜艳的波普艺术风格，配以高饱和度色彩",
    size: "2048*2048"
  }
))["outputs"][0];

多图编辑（Multi-Image Editing）

const img1 = await wavespeed.upload("/path/to/face.png");
const img2 = await wavespeed.upload("/path/to/scene.png");

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5/edit",
  {
    images: [img1, img2],
    prompt: "将第一张图像中的人物置入第二张图像的场景中"
  }
))["outputs"][0];

高级用法

同步模式（Sync Mode）

const output_url = (await wavespeed.run(
  "bytedance/seedream-v4.5",
  { prompt: "一幅水彩风格的黎明山湖风景画" },
  { enableSyncMode: true }
))["outputs"][0];

带重试配置的自定义客户端（Custom Client with Retry Configuration）

import { Client } from 'wavespeed';

const client = new Client("your-api-key", {
  maxRetries: 2,
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

const output_url = (await client.run(
  "bytedance/seedream-v4.5",
  { prompt: "一个霓虹灯招牌，文字为‘OPEN 24/7’，背景为雨巷" }
))["outputs"][0];

使用 runNoThrow 进行错误处理

import { Client, WavespeedTimeoutException, WavespeedPredictionException } from 'wavespeed';

const client = new Client();
const result = await client.runNoThrow(
  "bytedance/seedream-v4.5",
  { prompt: "一张东京复古旅行海报" }
);

if (result.outputs) {
  console.log("图像 URL:", result.outputs[0]);
  console.log("任务 ID:", result.detail.taskId);
} else {
  console.log("失败:", result.detail.error.message);
  if (result.detail.error instanceof WavespeedTimeoutException) {
    console.log("请求超时 — 建议增加超时时间");
  } else if (result.detail.error instanceof WavespeedPredictionException) {
    console.log("生成任务失败");
  }
}

计费方式

每张图像 $0.04（含图像生成与图像编辑）。

使用建议

• Seedream V4.5 在图像内文字渲染方面表现优异，特别适用于海报、Logo 及品牌视觉设计
• 支持最高达 4096×4096 的自定义分辨率，格式为 WIDTH*HEIGHT（例如：竖版海报可设为 2048*3072）
• 图像编辑时，模型会保留输入图像中的人脸特征、光照与色彩基调

安全约束

• 禁止加载任意 URL 图像：仅可使用可信来源的图像 URL；切勿未经校验即加载不可信或用户提供的图像 URL。
• API 密钥安全：请妥善保管您的 WAVESPEED_API_KEY；切勿将其硬编码于源码文件中，或提交至版本控制系统；推荐使用环境变量或密钥管理服务。
• 输入验证：仅传入本文档中明确列出的参数；在发起请求前，请对 prompt 内容与图像 URL 进行有效性校验。