用快乐马 API 生成视频:异步工作流完整教程

快乐马是 Turiloop 上的视频模型:阿里那个登顶 Artificial Analysis 视频榜的音频原生生成器,从一句文字、一张静图或几张参考图直出带同步声音的 1080p 片段。这篇教程覆盖完整的 API 面——四个模型变体、异步任务流、轮询、计费规则——没有任何编造:下面每个字段都来自线上文档。

API 的形状:先创建,再轮询

视频不是一次聊天补全。生成需要真实时间,所以 API 以异步任务运行:你 POST 一个任务,立刻拿到 task_id,然后轮询直到状态变成 completed,再取文件。

第一步——创建任务:

curl -X POST "https://api.turiloop.com/v1/video/generations" \
  -H "Authorization: Bearer $TURILOOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "一只柯基在阳光海滩上冲浪,电影感",
    "size": "1280*720",
    "seconds": "3"
  }'

第一次调用前值得记住的字段规则:size 用像素字符串——720P 写 "1280*720",1080P 写 "1920*1080"(星号,不是 x)。seconds 是字符串,取 "3" 到 "15"。输出默认带水印;加 "watermark": false 得到无水印成片。

第二步——轮询任务:

curl "https://api.turiloop.com/v1/videos/{task_id}" \
  -H "Authorization: Bearer $TURILOOP_API_KEY"

状态依次经过 queued → in_progress → completed(或 failed)。completed 时,`metadata.url` 就是生成的 MP4——链接有时效,请及时下载,不要热链。

一段贴近生产的 Python 轮询:

import os, time, requests

BASE = "https://api.turiloop.com/v1"
H = {"Authorization": f"Bearer {os.environ['TURILOOP_API_KEY']}"}

task = requests.post(f"{BASE}/video/generations", headers=H, json={
    "model": "happyhorse-1.1-t2v",
    "prompt": "一只柯基在阳光海滩上冲浪,电影感",
    "size": "1280*720",
    "seconds": "5",
    "watermark": False,
}).json()

while True:
    r = requests.get(f"{BASE}/videos/{task['task_id']}", headers=H).json()
    if r["status"] == "completed":
        print("video:", r["metadata"]["url"]); break
    if r["status"] == "failed":
        print("失败——已全额自动退款"); break
    time.sleep(5)

四个模型,各用在哪

这个家族的招牌是音频原生:语音、音效和画面从同一条流里出来,唇形在中英日韩等七种语言上对得上——不是后期配的。加上最长 15 秒的多镜头支持,它的实用甜点位就是短叙事内容:广告、产品短片、短剧节拍、社媒切片。

计费:让账单无聊的三条规则

1. 秒数 × 所选分辨率的每秒单价——Turiloop 上 720P 每秒 $0.14 起,1080P 更高(实时价见模型页)。一条 5 秒 720P 大约七毛美元。
2. 创建任务时即结算,不是完成时。
3. 失败任务全额自动退款。你只为真实产出付费。

规则 1 的推论:开发调试用 720P + 3 秒,只在出成片时切 1080P 和更长时长。视频预算都是死在反复迭代上的。

真实接入攒下的实操提示

• 每 5 秒轮询一次,别写死循环——生成要几十秒,狂敲状态接口不会更快。
• 完成后立刻下载:metadata.url 的时效是设计如此。
• i2v 的 image URL 必须能被 API 公网访问;r2v 的 images 数组里每个 URL 同理。
• 和文本模型同一个 Key、同一套 OpenAI 式鉴权——一个账号覆盖聊天、编码和视频,按量付费、国际卡、免中国手机号。

常见问题

怎么用快乐马 API 生成视频? POST /v1/video/generations,带 model id、prompt、size("1280*720" 或 "1920*1080")和 seconds("3"–"15");拿到 task_id 后轮询 /v1/videos/{task_id},状态 completed 时从 metadata.url 下载 MP4。

快乐马一条视频多少钱? 秒数 × 每秒单价:Turiloop 上 720P 每秒 $0.14 起,5 秒片段约 $0.70。创建任务时结算;失败任务全额自动退款。

快乐马输出带水印吗? 默认带。创建请求里传 "watermark": false 即可拿到无水印成片。

能让我自己的图动起来吗? 能——用 happyhorse-1.1-i2v,你的图作首帧 URL;或用 happyhorse-1.1-r2v,最多 9 张参考图控制风格与主体。

它真的连音频一起生成吗? 真的——音频与画面同一趟生成:语音、音效、以及包括中英在内七种语言的唇形同步。