Seedance 2.5 文生视频 API 怎么用？curl 和 Python 直接跑

TL;DR

• seedance-2.5/text-to-video 只要一段提示词就能出视频，单条 4–30 秒，自带声音。打开模型页 就能在线生成，新用户注册送 200 积分。
• 按秒计费：720p 每秒 $0.204，1080p 每秒 $0.516。5 秒 720p 是 $1.02。
• API 两步走：POST /v1/tasks 提交，拿 taskId 查结果。下面的 curl 和 Python 复制就能跑。

先看一条实际效果

下面这条 8 秒 720p 视频，是一段提示词、一次请求生成的，蒸奶声、杯子碰撞声和店里的人声都是模型自己配的：

VIDEO

A barista in a small morning cafe pours steamed milk into a cup, drawing a latte art leaf.
The camera starts on her hands and slowly pulls back to reveal the counter and a sign on the wall that reads 'OPEN'.
Warm window light, realistic, smooth motion. Sound: milk steaming, cups clinking, quiet cafe chatter.

用这个提示词生成 →（8 秒、720p）

seedance-2.5/text-to-video，720p，8 秒，带声音，$1.632。

两条上手路线

在线试用（不写代码）

1. 打开 Seedance 2.5 文生视频 模型页，注册或登录。
2. 粘贴提示词，选时长、分辨率、画幅。
3. 点生成，出片后直接下载。

API 调用

1. 在控制台创建 API Key。
2. POST https://api.hiapi.ai/v1/tasks 提交任务，返回 taskId。
3. GET /v1/tasks/{taskId} 查状态，status 为 success 时从 output[0].url 下载视频。

curl：第一条视频

先跑一条 5 秒 720p，$1.02：

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5/text-to-video",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，灰尘在光里漂浮，镜头跟着纸飞机缓慢移动",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'

返回：

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

查结果：

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

生成中 status 是 handling，完成后变成 success，视频地址在 output[0].url。

Python：提交、轮询、下载

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.5/text-to-video", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "一架纸飞机滑过洒满阳光的办公室，灰尘在光里漂浮，镜头跟着纸飞机缓慢移动",
    duration=5, resolution="720p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

参数一览

文生视频不收任何图片、视频地址。要从一张图开始，换 Seedance 2.5 图生视频；要参考已有视频的动作和运镜，换 Seedance 2.5 参考生视频。

算一下费用

$10 在 720p 下大约能生成 49 秒。建议先用 720p 短时长把提示词调好，再出 1080p 成片。更细的账看 Seedance 2.5 API 价格。

上线前注意

• 用回调代替轮询：请求顶层（和 input 同级）加 "callback": {"url": "https://你的域名/hiapi/callback"}，任务结束时 HiAPI 主动通知，按 taskId 去重。
• 及时转存：output[0].url 是临时链接（默认保留约 7 天），拿到后马上存到自己的存储。
• 重试带幂等键：请求头加 Idempotency-Key，同一个键重试只会创建一次任务，不会重复扣费。
• 参数写全：显式写上 duration、resolution 和 aspect_ratio，费用和画幅才能和预算对上。
• 失败自动退款：只按成功生成的视频计费。

常见问题

提示词能写中文吗？

能。镜头怎么动、主体怎么动、声音有什么，分句写效果最稳。

最长能生成多久？

单条 4–30 秒。比 Seedance 2.0 的 15 秒上限长一倍，适合一镜到底的长镜头。

不要声音能省钱吗？

generate_audio 设为 false 可以关掉声音，但价格按分辨率和秒数计，不会因此变便宜。

和 Seedance 2.0 怎么选？

要更长的单条、更多参考素材选 2.5；预算优先或者要 4K，选 2.0 的 ext 线路（720p 每秒 $0.134）。详细对比看 Seedance 2.5 和 2.0 的区别。

想要更多现成的写法，看 Seedance 2.5 使用手册；也可以复制上面的拉花提示词，去模型页生成。