seeddance-ai-video

# SeedDance AI 视频生成

字节跳动 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：

```bash
npm install seeddance-sdk
```

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

## 配置

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

```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 密钥配置

设置环境变量：

```bash
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
```

## 使用示例

### 文本到视频

```javascript
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();
```

### 图片到视频

```javascript
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');
}
```

### 视频风格转换

```javascript
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}`);
}
```

## 批量处理

```javascript
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

```javascript
// 长时间任务使用 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}秒`);
```

## 错误处理

```javascript
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})`);
  }
}
```

## 价格说明

| 功能 | 免费版 | 专业版 | 企业版 |
|------|--------|--------|--------|
| 文本到视频 | 100次/天 | 5000次/天 | 无限制 |
| 图片到视频 | 50次/天 | 2000次/天 | 无限制 |
| 最大时长 | 10秒 | 30秒 | 5分钟 |
| 最大分辨率 | 720p | 1080p | 4K |
| 并发数 | 1 | 5 | 50 |
| 技术支持 | 社区 | 邮件 | 专属客服 |

## 常见问题

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

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

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

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