HiAPI
博客

使用指南

Seedance 2.0@ext 短视频:面向社交短片的实用 API 工作流

用 seedance-2.0@ext 异步任务 API,将一条详细提示词变成竖屏、带音频的成片

2026年11月3日
Seedance 2.0@ext 短视频:面向社交短片的实用 API 工作流

如今大多数社交内容发现都发生在短视频上,而一条干净的竖屏短片通常意味着要拍摄、要剪辑,或两者兼有。hiapi 上的 seedance-2.0@ext 跳过了这些步骤:写一条详细提示词,调用一个 API 端点,几分钟后就能拿回一条成品 9:16 视频——包含音频。

这篇实操指南用一条真实生成的短片,从头到尾讲清整个工作流:提示词是如何组织的、异步任务 API 调用实际怎么用、花了多少钱,以及定价在哪些地方不再符合你的预期。

为什么短视频选 seedance-2.0@ext

seedance-2.0@ext 是 hiapi 上 seedance-2.0 模型家族的 ext 路由——一条独立路由,有自己的定价和参数集,与默认的 seedance-2.0 路由不同。它专为竖屏、社交原生输出打造:原生 9:16 构图、在手机屏幕上观感好的运镜,以及在与视频同一次生成中就产出的音频,而不是事后追加。

这种组合——竖屏构图加原生音频——正是它适合 TikTok 和 Reels 风格短片的原因,而不是用一个通用视频模型,事后再自己裁切、配乐。

提示词:这条短片实际用的是什么

我们为本文端到端生成了一条演示短片:一杯冷萃咖啡倒入装满冰块的玻璃杯中的竖屏产品特写,风格面向社交信息流。以下是实际输出,以及生成它的那条原始提示词。

面向社交信息流的竖屏 9:16 产品特写展示:一只磨砂玻璃杯居中放在阳光照射的大理石台面上。镜头从空杯上方缓慢俯拍推近,杯中装满透明冰块,反射着黄金时刻的光线。第二秒时,一股冷萃咖啡从画面外上方倒入,旋绕并使冰块变暗,随后奶液以轻柔的螺旋纹路丝丝渗入。水珠顺着玻璃滑下,冷气在逆光中向上飘散。镜头从俯拍缓慢弧线移动到低角度四分之三主视角,最终落在清晰的浅景深特写上,背景窗外透出温暖散景。明亮的自然商业布光、光泽反射、浅景深、超干净的产品视频美学、平滑的手持微动、高级商业质感。原生音频:轻柔的倾倒细流声、冰块碰撞玻璃声、轻微的咖啡馆环境低噪,无音乐。无可读文字、无标志、无人物、无手部、无剪辑。

结果:720×1280(9:16)、24fps、约 8 秒,文件内置原生 AAC 立体声音频——无需单独的拟音流程。

这条提示词为什么有效

这条提示词做了几件更简短、更含糊的提示词不会做的事:

  • 它给镜头一条路径,而不是单一画面。“俯拍推近”→“缓慢弧线移动到低角度四分之三主视角”→“清晰的近景特写”描述的是贯穿整条短片的运动,而不是一个静态构图。
  • 它给动作定了时间。“第二秒时,一股冷萃咖啡倒入”把倒入动作锚定在具体时刻,而不是让模型去猜“有趣的部分”该在何时发生。
  • 它叠加了材质与光线线索。水珠、冷气、温暖散景、光泽反射——这些细节让一条产品镜头从普通走向高级。
  • 音频直接写进提示词,而不是当成事后补充:倾倒细流声、冰块碰撞声、环境低噪,并明确不要音乐。模型会把声音与上方描述的视觉动作同步。
  • 它以负面清单收尾。“无可读文字、无标志、无人物、无手部、无剪辑”在产品类生成中提前挡掉了最常见的失败模式。

把提示词当作一份简短的创意简报,而不是一句配文——这才是输出质量真正的差别所在。

用 /v1/tasks API 复现

seedance-2.0@ext 通过 hiapi 的异步任务端点运行。你提交一个任务,轮询直到完成,然后从响应里取出视频。

提交:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0@ext",
    "input": {
      "prompt": "<your prompt>",
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "duration": 8,
      "generate_audio": true
    }
  }'

prompt 和 aspect_ratio 是必填项——省略 aspect_ratio 时,调用会在到达生成之前就校验失败。resolution、duration(4–15 秒)和 generate_audio 是可选项;上面的值接近生成本文短片时所用的配置。

如果你是从图生视频的思路过来,值得提醒一点:定价页为这个模型列出了图生视频费率,但实际输入 schema 只接受文本提示词——图片或参考帧字段都会被拒绝。无论定价标签怎么写,实际上它是一个文生视频模型。

轮询结果:

curl https://api.hiapi.ai/v1/tasks/<task_id> \
  -H "Authorization: Bearer $HIAPI_API_KEY"

一旦 status 报告成功,output[0].url 就指向成品 .mp4。该链接是临时的——根据任务响应中的过期窗口大约一周——所以请立即下载字节并自行存储,而不是直接链接到它。

定价:4K 的怪现象

seedance-2.0@ext 按输出秒数计费,费率随分辨率档次变化:

分辨率 每秒价格
720p $0.149
1080p $0.373
2K $0.662
4K $0.467

注意,在这个模型上 4K 比 2K 更便宜——$0.467/秒 对 $0.662/秒。这不是笔误,也不是常见模式;这里的多数模型价格随分辨率单调上升。不要假设其他模型也如此,并且在把基于分辨率的成本逻辑写进流水线之前,重新核对 /api/pricing,因为这类档次确实会被调整。

供参考,上面那条 8 秒、720p 的演示短片生成花了 $1.19——就是 720p 档下简单的 时长 × 每秒费率 计算。

按短片实际投放位置选择分辨率

仅 720p → 1080p 这一跳成本就增加约 2.5 倍,所以在批量生成任何内容之前,分辨率是值得先考虑的那个杠杆:

  • 信息流与 Stories 投放(TikTok、Reels、Shorts)几乎总是在手机上观看,像素密度只有 1080p 实际密度的一小部分——720p 在那里通常无法分辨,而且是最便宜的档位。
  • 1080p 值得用,当短片可能被复用到落地页主视觉,或可能以大于手机屏幕的尺寸渲染的付费投放时。
  • 2K 和 4K 适合你计划在后期裁切、缩放或稳定的源素材——额外分辨率给你重新构图的空间而不出现可见画质损失。鉴于上面的价格表,在这个特定模型上,4K 是两者中更划算的选择。

常见问题

seedance-2.0@ext 支持图生视频,而不仅是文生视频吗? 不支持——尽管定价页为这个模型列出了图生视频费率,ext 路由的实际 /v1/tasks schema 只接受文本提示词;图片 URL、参考帧和参考视频字段都会被拒绝。在平台模型列表另有说明之前,请把它当作仅文生视频。

我能控制生成短片的时长吗? 可以,通过可选的 duration 字段,取 4 到 15 秒的整数。省略时模型会应用默认值;如果下游模板期望特定长度,显式设置更稳妥。

视频会自动带音频吗? 原生音频生成通过可选的 generate_audio 字段提供。把你想要的音频直接写进提示词——就像上面的“轻柔的倾倒细流声、冰块碰撞玻璃声、轻微的咖啡馆环境低噪”——就能让它与画面动作同步,无需单独的音频流程。

4K 真的比 2K 便宜,还是显示 bug? 这是截至本文撰写时(2026 年 8 月)的当前实际定价,不是 bug——但分辨率定价可能变化,所以在成本模型中依赖它之前,请对照 /api/pricing 确认。

返回的视频 URL 有效期多久? 已完成任务的 output[0].url 是临时链接,根据任务的过期元数据大约有效一周。请自行下载并存储文件,而不是长期链接到它。

接下来做什么

该模型的完整参数细节和当前定价见 seedance-2.0@ext 模型页和 hiapi 定价页。想了解更多围绕同一模型的提示词模式,Seedance 2.0@ext 提示词配方有更多实例,而基于 Seedance 2.0 的短视频产品展示则讲解了同一套异步任务工作流应用到不同创意简报上的做法。

立即开始构建持久 AI 产物

获取 API 密钥,通过一个基于任务(task)的 API 调用图像、视频和音频模型。

阅读 API 文档