mcpField
S
seedance

seedance

github.com/okou-ai创意与媒体8155 次安装1 周前更新
代码仓库

关于 seedance

通过 Seedance API 生成视频的技能，说明文本及图像输入流程、异步任务轮询和模型选项，并要求生成前确认关键帧预览。

主要功能

  1. 01文本生成视频
  2. 02图像与参考素材输入
  3. 03异步任务轮询
  4. 04标准与快速模型选项
  5. 05预览确认流程
  6. 06视频下载指引

适用场景

  1. 01根据文本提示生成短片
  2. 02将图像作为首帧制作动画
  3. 03使用角色或风格参考素材
  4. 04生成前确认关键帧预览

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/okou-ai/okou-skills --skill seedance

安装后在 Claude Code 中输入/seedance确认已加载。

详细介绍

故障排查

如果请求失败，请运行 okou doctor check-connector --env-name SEEDANCE_TOKEN 或 okou doctor check-connector --url https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks --method POST

视频预览

  1. 生成视频前，准备几个符合用户主题、风格和宽高比的关键帧。重复使用合适的用户提供或已获批准的图像。
  2. 通过可访问的链接展示实际图像，简要描述预期的动态效果，并请用户确认。结束本轮对话并等待；确认前不要启动视频任务。如果用户提出修改要求，请调整预览。
  3. 确认后，生成视频。如果所选模型支持，请将获批图像用作首帧／尾帧或参考图；否则，请在提示词中遵循获批的视觉方向。预览未变时，重复使用现有确认。

预览消息应简短：展示图像、简要描述动态效果，并提出一个确认问题。

使用方法

视频生成是异步的：提交任务 → 获取任务 ID → 轮询直到状态为 succeeded → 使用视频 URL（有效期为 24 小时）。

1. 文本生成视频（标准 — 1080p）

写入 /tmp/seedance_request.json：

{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    { "type": "text", "text": "A golden retriever puppy playing in autumn leaves, cinematic slow motion" }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'
2. 文本生成视频（快速 — 720p，成本较低）

写入 /tmp/seedance_request.json：

{
  "model": "dreamina-seedance-2-0-fast-260128",
  "content": [
    { "type": "text", "text": "A timelapse of clouds rolling over mountain peaks, epic wide angle" }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'
3. 轮询任务状态

将 <task-id> 替换为上述创建调用返回的 ID。

curl -s "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks/<task-id>" --header "Authorization: Bearer $SEEDANCE_TOKEN" | jq '{status: .status, video_url: .content.video_url, duration: .duration, resolution: .resolution}'

轮询直到 status 为 succeeded。终态：succeeded、failed、expired、cancelled。

4. 图像生成视频（为首帧添加动画）

写入 /tmp/seedance_request.json：

{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/your-image.jpg" },
      "role": "first_frame"
    },
    { "type": "text", "text": "The camera slowly zooms in on the subject" }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'
5. 参考图生成视频（角色／风格参考）

写入 /tmp/seedance_request.json：

{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/character.jpg" },
      "role": "reference_image"
    },
    { "type": "text", "text": "The character walks forward confidently in an urban environment" }
  ],
  "resolution": "1080p",
  "ratio": "9:16",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'
6. 下载生成的视频

将 <video-url> 替换为已完成任务中的 content.video_url。

curl -sL "<video-url>" -o /tmp/seedance_output.mp4

模型参考

模型 ID档位最大分辨率时长
dreamina-seedance-2-0-260128标准1080p4–15s 或 -1（智能）
dreamina-seedance-2-0-fast-260128快速720p4–15s 或 -1（智能）

关键参数

参数值默认值描述
resolution480p、720p、1080p720p输出分辨率
ratio16:9、4:3、1:1、3:4、9:16、21:9、adaptiveadaptive宽高比
duration4–15 或 -15时长（秒）；-1 = 智能自动
generate_audiotrue/falsetrue是否包含 AI 生成的音频
seed整数-1用于确保可复现的固定种子；-1 = 随机
watermarktrue/falsefalse是否为输出添加水印
return_last_frametrue/falsefalse是否同时以 PNG URL 的形式返回尾帧

图像角色值

角色描述
first_frame用作视频首帧的图像
last_frame用作视频尾帧的图像
reference_image角色／风格参考（最多 9 张图像）
reference_video视频风格参考（最多 3 个视频，仅支持 URL，不支持 Base64）
reference_audio音频参考（最多 3 段片段）

指南

  1. 视频 URL 将在 24 小时后过期——状态变为 succeeded 后立即下载
  2. 异步流程——POST 后务必轮询 GET；不要重新提交同一任务
  3. 速率限制——个人账户最多同时运行 3 个任务，每分钟 180 次请求（RPM）
  4. 图像输入——支持公共 URL 或 Base64（data:image/jpeg;base64,...）；视频输入仅支持 URL
  5. 不支持 flex 档位——Seedance 仅支持 service_tier: "default"
  6. 任务记录将过期——任务 ID 会在 7 天后删除

评论

支持 Markdown