Seedance 2.5 文生视频：用 hiapi API 构建短视频片段

短视频是一场数量游戏：TikTok、Reels 和 Shorts 都奖励发布频率，而为每条帖子手工拍摄 B-roll 素材无法规模化。Seedance 2.5 的文本生成视频端点只需一次 API 调用，就能把单个提示词变成一段成品竖屏片段，并带有同步音频——无需摄像机、无需剪辑时间线、无需单独配音。

本指南将完整走一遍我们通过 hiapi API 端到端生成的一段真实片段：确切的提示词、产出它的异步工作流、经核实的定价，以及一个可直接用于批量生产的模式，用来制作一组短视频而不是零散的单个片段。有关全部三个 seedance-2.5 端点的完整参数参考，请参阅完整的 API 指南。

为什么短视频内容适合用文本生成视频

短视频平台不需要电影级的长度——它们需要稳定的 6 至 15 秒片段供给，这些片段能无缝循环，并在一秒内抓住观众。seedance-2.5/text-to-video 正好契合这一需求：

• 每段最长可达 30 秒，支持七种宽高比，包括用于 TikTok/Reels/Shorts 的 9:16。
• 原生音频同步——模型会根据提示词中的动作生成环境音和音频线索，而不是生成一段静音片段让你事后配音。
• 提示词支持 11 种语言，如果你正在本地化短视频营销活动，这会很有用。
• 两档分辨率（480p 和 720p），因此你可以低成本生成草稿，只为真正要发布的片段支付 720p 费率。

一段真实片段，从头到尾

这是我们为本指南生成的一段片段：倒入拿铁拉花的特写，竖向取景，用于咖啡馆短视频。

我们提交的确切提示词，未经编辑：

咖啡师稳稳的手将蒸奶从不锈钢奶壶倒入白色陶瓷浓缩咖啡杯，奶流折叠成正在实时成形的罗塞塔拉花漩涡，温暖的金色时刻光线斜扫过吧台，背景中羊角面包和糕点柔和虚化，特写竖屏构图，轻柔蒸汽，咖啡馆环境声。

参数：aspect_ratio: "9:16"、resolution: "720p"、duration: 8。上面的输出是真实的、未经编辑的任务结果——8.06 秒，倒入声和咖啡馆环境嗡鸣由模型直接生成，而非后期添加。

API 工作流

seedance-2.5/text-to-video 通过 hiapi 的异步任务 API 运行——提交、轮询、下载。没有同步视频端点；每段片段都是一个后台任务。

import time
import requests

API_KEY = "YOUR_HIAPI_KEY"
BASE = "https://api.hiapi.ai/v1"

def generate_clip(prompt: str, aspect_ratio: str = "9:16",
                   resolution: str = "720p", duration: int = 8) -> str:
    submit = requests.post(
        f"{BASE}/tasks",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "seedance-2.5/text-to-video",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
                "duration": duration,
            },
        },
        timeout=30,
    )
    task_id = submit.json()["data"]["taskId"]

    while True:
        poll = requests.get(
            f"{BASE}/tasks/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        ).json()["data"]
        if poll["status"] == "success":
            return poll["output"][0]["url"]   # 临时链接——立即下载
        if poll["status"] == "fail":
            raise RuntimeError(poll)
        time.sleep(5)

clip_url = generate_clip(
    "咖啡师稳稳的手将蒸奶从不锈钢奶壶倒入白色陶瓷浓缩咖啡杯，"
    "奶流折叠成正在实时成形的罗塞塔拉花漩涡，温暖的金色时刻光线"
    "斜扫过吧台，背景中羊角面包和糕点柔和虚化，"
    "特写竖屏构图，轻柔蒸汽，咖啡馆环境声。"
)

# 输出 URL 会过期（带有 expireAt 时间戳）——请立即下载并
# 持久化到你自己的存储，不要把它当作热链接保留
video_bytes = requests.get(clip_url, timeout=60).content
open("clip.mp4", "wb").write(video_bytes)

任务响应从不回显你原始的提示词——只返回 model、status、output 和时间戳——因此如果你之后需要复现或变化某段片段，请自行记录提交过的内容。

定价：两档，没有 1080p

根据 hiapi 的定价端点实时核实——seedance-2.5/text-to-video 按输出秒数计费，有两档分辨率，没有 1080p 选项：

分辨率	每秒价格	8 秒片段
480p	$0.1395	约 $1.12
720p	$0.3019	约 $2.42

720p 每秒价格约为 480p 的 2.2 倍——值得先用 480p 生成草稿，等提示词打磨好后再只为 720p 付费。完整的参数和定价细节在 seedance-2.5/text-to-video 模型页面；费率截至 2026-08 有效，可能变化，因此在为大批量做预算前请查看该页面。

制作一组短视频，而不只是一段

单段片段只是演示；内容日历需要批量生产。把每段片段当作以提示词为键的幂等任务，这样崩溃后重跑不会重复计费：

import hashlib

PROMPTS = [
    "咖啡师将蒸奶倒入浓缩咖啡杯，罗塞塔拉花成形，金色时刻光线，特写竖屏构图。",
    "新鲜手冲咖啡通过滤纸滴落时升起的蒸汽，晨光透过咖啡馆窗户，竖屏构图。",
    "一只手将一袋咖啡豆轻敲在木质秤上，咖啡豆落定，柔和的咖啡馆氛围，特写竖屏构图。",
]

def job_key(prompt: str) -> str:
    return hashlib.sha1(prompt.encode()).hexdigest()[:12]

results = {}
for prompt in PROMPTS:
    key = job_key(prompt)
    if key in results:          # 本轮已生成过
        continue
    results[key] = generate_clip(prompt, resolution="480p", duration=6)
    # 立即持久化每个结果——参见上面的下载步骤

先以 480p 生成整组，评估哪些片段真正适合营销活动，然后只以 720p 重跑胜出的片段。当你需要批量生产而非一次性制作时，这个两轮习惯是成本上最大的杠杆。

与 Seedance 2.0 的对比

如果你用过 Seedance 2.0，2.5 的文本生成视频层级保持相同的提交-轮询-下载任务形态——集成侧没有变化。迁移流水线前值得了解的实际差异：2.5 默认为每段片段添加原生音频同步，且其分辨率阶梯更简单（仅 480p/720p，而 2.0 有额外档位）。如果你的工作流依赖 2.5 不提供的分辨率，在假设对等前请查看该模型自己的页面了解当前规格。

常见问题

seedance-2.5/text-to-video 支持 1080p 吗？ 不支持——截至 2026-08，该模型仅提供 480p 和 720p。如果你需要 1080p 输出，在围绕此端点构建流水线前，请在模型目录中查找支持它的模型。

音频是真实的，还是需要单独添加？ 它由模型作为任务的一部分生成——上面演示片段中的倒入声和咖啡馆环境嗡鸣并非后期添加。如果你需要品牌专属音乐或配音，之后仍可叠加自己的音频。

生成一段片段需要多长时间？ 任务完成时间随时长和分辨率变化；大致为每段一到几分钟，并且务必轮询，而不是假设固定等待时间。

我可以在不同平台上复用同一提示词跨宽高比吗？ 可以——aspect_ratio 是与提示词分开的参数，因此同一提示词可以按 9:16 为 TikTok/Reels 重新提交，按 16:9 为 YouTube 提交，而无需重写场景描述。

如果输出 URL 在我下载前过期了怎么办？ 你需要重新提交任务——output[0].url 是绑定到 expireAt 时间戳的临时链接，并非永久存储。在任务报告 success 后立即下载并持久化每段片段。

要点

• seedance-2.5/text-to-video 是用于短视频内容的提示词输入、片段输出端点——草稿和社交填充内容选 480p，当片段是最终资产时选 720p。
• 按时长而非按片段做预算：720p 每秒成本约为 480p 的 2.2 倍，因此一段 8 秒的 720p 片段成本已约 $2.42。
• 任务输出 URL 会过期——轮询成功后立即下载并持久化到永久存储。
• 原生音频同步意味着短视频填充内容通常不需要单独的配音或音效处理。
• 该模型目前没有 1080p 档——在构建假设它有该档的流水线前，请查看模型页面。

准备好试试了吗？前往 seedance-2.5/text-to-video 模型页面查看完整参数参考，或浏览 hiapi 的完整视频模型目录，将它与 Kling 3.0 Turbo 等图生视频选项进行比较，为你的下一批短视频做准备。