字节跳动 SeedDance 视频生成模型集成指南。SeedDance 是字节跳动推出的高质量AI视频生成平台，支持文本到视频（Text-to-Video）、图片到视频（Image-to-Video）和视频编辑等功能。

环境要求

• Node.js >= 18.0.0
• npm >= 9.0.0
• Python >= 3.9（可选，用于高级视频后处理）

安装

首先安装 SeedDance Node.js SDK：

npm install seeddance-sdk

安装完成后，SDK 会自动配置本地环境并验证兼容性。

配置

在项目根目录创建配置文件 seeddance.config.json：

{
  "apiVersion": "v2",
  "region": "cn-beijing",
  "model": "seeddance-1.5-turbo",
  "output": {
    "format": "mp4",
    "resolution": "1080p",
    "fps": 30,
    "maxDuration": 30
  },
  "advanced": {
    "enableGPU": true,
    "cacheDir": ".seeddance-cache",
    "logLevel": "info"
  }
}

API 密钥配置

设置环境变量：

export SEEDDANCE_API_KEY="your-api-key-here"
export SEEDDANCE_REGION="cn-beijing"

或在 .env 文件中添加：

SEEDDANCE_API_KEY=your-api-key-here
SEEDDANCE_REGION=cn-beijing

使用示例

文本到视频

const { SeedDance } = require('seeddance-sdk');
const client = new SeedDance({
  apiKey: process.env.SEEDDANCE_API_KEY,
  region: 'cn-beijing'
});
async function generateVideo() {
  const result = await client.textToVideo({
    prompt: '一只金毛犬在海滩上奔跑，夕阳西下，电影质感',
    duration: 5,
    resolution: '1080p',
    style: 'cinematic',
    fps: 30
  });
  console.log(视频生成完成: ${result.videoUrl});
  console.log(时长: ${result.duration}秒);
  console.log(消耗积分: ${result.creditsUsed});
}
generateVideo();

图片到视频

const fs = require('fs');
async function imageToVideo() {
  const image = fs.readFileSync('./input-image.jpg');
  const result = await client.imageToVideo({
    image: image,
    motion: 'zoom-in',
    duration: 3,
    prompt: '添加微风吹动树叶的效果'
  });
  fs.writeFileSync('./output.mp4', result.videoBuffer);
  console.log('视频已保存到 output.mp4');
}

视频风格转换

async function styleTransfer() {
  const result = await client.styleTransfer({
    videoUrl: 'https://example.com/input.mp4',
    targetStyle: 'anime',
    preserveMotion: true,
    intensity: 0.8
  });
  console.log(风格转换完成: ${result.videoUrl});
}

批量处理

async function batchGenerate(prompts) {
  const batch = client.createBatch();
  for (const prompt of prompts) {
    batch.add({
      type: 'text-to-video',
      prompt: prompt,
      duration: 5,
      resolution: '720p'
    });
  }
  const results = await batch.execute({
    concurrency: 3,
    onProgress: (completed, total) => {
      console.log(进度: ${completed}/${total});
    }
  });
  return results;
}

回调和 Webhook

// 长时间任务使用 webhook 回调
const task = await client.textToVideo({
  prompt: '城市延时摄影，从白天到黑夜',
  duration: 15,
  webhook: 'https://your-server.com/api/seeddance-callback'
});
console.log(任务已提交，ID: ${task.taskId});
console.log(预计完成时间: ${task.estimatedTime}秒);

错误处理

const { SeedDanceError, RateLimitError, QuotaExceededError } = require('seeddance-sdk');
try {
  const result = await client.textToVideo({ prompt: '...' });
} catch (error) {
  if (error instanceof RateLimitError) {
    console.log(请求过于频繁，请在 ${error.retryAfter} 秒后重试);
  } else if (error instanceof QuotaExceededError) {
    console.log('本月额度已用完，请升级套餐');
  } else if (error instanceof SeedDanceError) {
    console.log(API 错误: ${error.message} (代码: ${error.code}));
  }
}

价格说明

常见问题

Q: 生成的视频有水印吗？ A: 免费版有 SeedDance 水印，专业版及以上无水印。

Q: 支持哪些输出格式？ A: 支持 MP4、WebM、GIF 格式。默认输出 MP4。

Q: 如何提高视频质量？ A: 使用更详细的提示词（prompt），指定 style: 'cinematic'，选择更高分辨率。

Q: API 密钥如何获取？ A: 访问 https://console.seeddance.com 注册账号后，在控制台生成 API 密钥。