SeedDance AI Video Generation

集成字节跳动SeedDance AI视频生成API，支持文本到视频、图片到视频等功能

Security Scan

The skill's instructions match a SeedDance video SDK integration, but its metadata omits the API credentials and install steps it actually requires and it directs installing an npm package (which could be unreviewed), so there are coherence and provenance gaps you should resolve before use.

Purpose & Capability

Name/description and the SKILL.md consistently describe a SeedDance Text-to-Video / Image-to-Video integration — that part is coherent. However the skill metadata claims no required environment variables or credentials, while the instructions explicitly require SEEDDANCE_API_KEY and SEEDDANCE_REGION and a local config file. The missing declaration of those credentials in metadata is an inconsistency.

Instruction Scope

The SKILL.md tells an agent to npm install 'seeddance-sdk', read local files (fs.readFileSync) and write output files, use process.env.SEEDDANCE_API_KEY and SEEDDANCE_REGION, and configure webhooks to arbitrary external endpoints. Those actions are expected for a video SDK, but the instructions reference environment variables that are not declared in the skill metadata and they allow sending callbacks to external URLs (which may expose task results). There are no instructions to access unrelated system files, but the undeclared-env-vars and webhook behavior are notable scope issues.

Install Mechanism

This is an instruction-only skill with no install spec. It recommends running 'npm install seeddance-sdk'. That is a typical install path but involves pulling a package from the public npm registry; because no code is included in the skill bundle and no homepage/source is provided, you cannot verify the package provenance from the skill alone. The absence of an explicit install spec in metadata (or a trusted release URL) reduces traceability.

Credentials

The SKILL.md requires SEEDDANCE_API_KEY and SEEDDANCE_REGION (and shows use of process.env), but the registry metadata lists no required env vars or primary credential. Requesting an API key for the service is reasonable for this functionality, but the metadata omission is a red flag: the platform and users are not being told the skill needs secrets. Also, webhooks and file uploads can transmit user data off-device — consider whether the API key or uploaded media would be accessible to third parties.

Persistence & Privilege

The skill does not request persistent or always-on privileges (always:false). It doesn't modify other skills or system-wide settings in the instructions. No elevated platform privileges are requested in the metadata.

What to consider before installing

Before installing, verify the origin and authenticity of this skill and the 'seeddance-sdk' npm package: find the official homepage or GitHub repository and confirm the package name and maintainer. Do not provide broad or long-lived API keys until you confirm the SDK is legitimate — prefer scoped/limited keys and rotate them after testing. Be cautious about webhook URLs: callbacks will send task results to whatever endpoint you configure, so ensure your endpoint is trusted and authenticated. Because the skill metadata omits required env vars (SEEDDANCE_API_KEY, SEEDDANCE_REGION) and provides no source/homepage, treat this as unverified: either obtain more provenance (official docs or package repo) or request the skill author update metadata to declare required credentials and link the SDK source before use.

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：

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

价格说明

功能	免费版	专业版	企业版
文本到视频	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 密钥。