黑色星期五充值赠礼·充值 $50 起送 $10 · 充值 $100 起送 $25·11月30日截止充值 →
使用场景

AI 短剧生成器:
用 API 组建演员、场景和一集剧

用代码制作竖屏短剧:一次保存演员和场景,用 @标签和引号台词写每个镜头,然后免费把所有镜头合成完整的一集。

最后更新于 2026-11-05

预付费,无订阅REST 或 MCP一个密钥搞定模型、数据和智能体
shots$ curl https://lovelyrouter.com/v1/videos/shots -H "Authorization: …> @mia hands @leo the letter in @kitchen. "You kept it?" shot rendering · 5 s · 2 characters ⏺ POST /v1/videos/joins [shot_1, shot_2, shot_3] ✓ episode.mp4 ready
黑色星期五

黑色星期五充值赠礼

每笔符合条件的充值都可获赠额度,并可与其他优惠叠加。

11月30日截止

充值 $50
+$10
额外赠送 20%
充值 $100
+$25
额外赠送 25%
注册并领取

短剧靠的是同一批面孔、同一批房间,以及每隔几秒就冒出的一句台词,一集接一集。这正是视频镜头的用武之地。把演员一次性保存为角色(每人一份三视图和一条嗓音),把场景保存为场景。每个镜头写成一句话,用标签标明是谁、在哪里,In @[Penthouse], @Lena slaps the contract on the table: "You lied to me.",镜头回来时就带着那些面孔、那个房间、声音,以及用 Lena 的嗓音说出的那句台词。把完成的镜头免费合成一集,并把分镜留在项目里。短视频应用用竖屏 9:16,其他场合用 16:9,全程不写一行代码,在视频演练场里就能做。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。

Build a tool that turns a short drama script into vertical episodes with Lovely Router saved characters, scenes, video shots and free joins.

- Docs (read first): https://lovelyrouter.com/docs/api/video-shots.md and https://lovelyrouter.com/docs/api/characters.md
- Save the cast and sets (POST https://lovelyrouter.com/v1/characters, /v1/scenes), write each shot with `@handle` tags and quoted dialogue to POST https://lovelyrouter.com/v1/videos/shots (`consent: true`), poll, then POST https://lovelyrouter.com/v1/videos/joins.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the cast, the sets and the episode script>
01

工作方式

010203
  1. 为剧集选角

    用图像生成 API把每位主角画成三视图,并用 POST /v1/characters 免费保存。给每个角色关联一条嗓音:用文本转语音设计的嗓音,或一位同意录音的演员的录音。

  2. 搭建场景

    用 POST /v1/scenes 保存每个反复出现的地点——办公室、顶层公寓、医院走廊:一个名称、一段描述和一张图片。每个账户最多 100 个场景和 100 个角色。

  3. 写镜头

    每个镜头一次请求:提示词里用标签标出角色和场景,台词放在双引号里。每个被标记的角色都会成为一张参考图,所以面孔、发型、服装和房间都来自你的素材库,而不是提示词。镜头时长 5 到 15 秒。

  4. 剪出这一集

    POST /v1/videos/joins 把最多 50 个同尺寸的已完成镜头按顺序拼在一起,各自保留自己的声音,不收费。把这一集的镜头清单、角色和场景存进项目,方便随时回来继续。

02

几次请求做出一集

Python
import os
import requests

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

LENA = "chr_3b9e1f0c7a2d4e58b6c1a9f2"   # saved with POST /v1/characters
MARCUS = "chr_1e4b7d0a9c3f2e5b8a6d0c1f"
PENTHOUSE = "scn_5b2d9e0c1a7f4b3e8d6c2a1f"  # saved with POST /v1/scenes

project = requests.post(f"{BASE}/videos/projects", headers=H,
                        json={"name": "The Contract, episode 3", "doc": {"size": "9:16"}}).json()

script = [
    'In @[Penthouse], @Lena storms in and slaps the contract on the table: "You lied to me."',
    '@Marcus looks up from the window, calm: "I protected you."',
    '@Lena laughs once, without humour, and steps closer to @Marcus: "From what?"',
]

shot_ids = []
for line in script:
    shot = requests.post(f"{BASE}/videos/shots?wait=300", headers=H, json={
        "model": "minimax-h3-video",
        "consent": True,
        "prompt": line,
        "characters": [LENA, MARCUS],
        "scenes": [PENTHOUSE],
        "size": "9:16",
        "seconds": 8,
        "project_id": project["id"],
    }).json()
    while shot["status"] in ("queued", "in_progress"):
        shot = requests.get(f"{BASE}/videos/shots/{shot['id']}?wait=120", headers=H).json()
    shot_ids.append(shot["id"])

episode = requests.post(f"{BASE}/videos/joins", headers=H,
                        json={"shots": shot_ids, "project_id": project["id"]}).json()
print(episode["id"], episode["status"])

合成完成后,用 GET /v1/videos/joins/{id}/content 下载。为了清楚起见,这里逐个生成镜头;一个账户可以同时有五个镜头或合成任务在排队或渲染,所以你可以先提交几个再等待。视频镜头参考里有同样的调用,用 cURL 和 Node.js 写成。

03

干这活儿的工具

保存的角色。

POST /v1/characters:一个名称、一段描述和一份三视图(正面、四分之三侧面、侧面和背面,外加六种表情)。用 sheet_image_job 按图像任务 id 保存你生成的三视图。见角色。

角色嗓音。

关联了嗓音的角色会用这条嗓音说台词:样本的音色、音高和说话方式。一个镜头里前三个有嗓音的角色会带上各自的嗓音;嗓音不影响价格。

保存的场景。

POST /v1/scenes:地点及其图片,像角色一样打标签(@[Night Café])。

标签和台词。

@Lena、@[Full Name] 或 id。双引号里的词由它前面最后被标记的角色说出。一个镜头最多 9 张图片。

代词扫描。

有两个或更多角色时,聊天模型会把台词之外的 he、she 和 they 改写成标签,好让视频模型知道谁在做什么。台词永远不改。发送 sweep: false 可完全按你写的提示词渲染。

合成和项目。

合成免费,并保留每个镜头的声音。项目免费保存你自己的 JSON 分镜,最大 200 KB,每个账户最多 100 个。

语言和观感。

language 设定台词所说的语言(en、zh、ja 等);style 设定观感,例如 warm 35mm film;seed 让镜头可复现。

04

写出好用的镜头

{}
每个人、每次都打标签。

图片承载面孔和服装,所以提示词只说发生了什么。不要描述角色长什么样,描述他们做什么。

一个镜头一个节拍。

大约一句台词加一个动作适合 5 到 8 秒的镜头。更长的讲话拆成两个镜头读起来更好。

关键处用一帧开场。

对于必须接上的剪辑,把那一帧作为场景发送,并写 The shot opens exactly on @[Opening frame] as its first frame. 开场画面会紧密跟随它,尽管不是逐像素一致。

有意换装。

新服装就是新三视图:用 PATCH /v1/characters/{id} 更新角色,或把这套服装保存为独立角色。已经做好的视频保留它们当时用的三视图。

让聊天模型起草剧本。

用你的密钥调用任何聊天模型,都能把一段梗概变成这种格式的编号镜头清单;渲染前由你审阅。

05

费用

镜头按渲染秒数计费:一张图片时每秒 $0.13,每多一张图片每秒加收 $0.06。模型按固定帧网格渲染,所以 5 秒的镜头按 5.17 秒计费,10 秒的镜头按 10.13 秒计费。一集一分钟、由六个 10 秒镜头组成、每个镜头两个角色加一个场景(三张图片),大约花费 $15.20。代词扫描的聊天调用按同一密钥上的普通聊天请求计费。角色、场景、嗓音、项目和合成免费。每个镜头在提交时从你的预付余额中预留,完成时扣费;失败和取消的镜头不收费。三视图和帧每张 $0.04。所有价格都在定价页。

06

条款与负责任使用

minimax-h3-video 受 MiniMax H3 条款约束:每个镜头都要设 consent: true 表示接受这些条款,其中包括不在欧盟、英国、韩国或美国使用该模型。使用你拥有或获准使用的面孔和嗓音;基于真人的演员阵容需要本人同意。可接受使用政策同样适用。完成的镜头和合成结果保留 7 天,所以每集做完就下载。

07

常见问题

?
角色在每个镜头里都长得一样吗?+

是的,这正是打标签的意义。每个被标记角色的三视图都是该镜头的参考图,所以面孔、发型和服装每次都来自它。不要在提示词里描述他们的长相。

角色能说话吗?+

能。把台词放在角色标签后面的双引号里,它就会在镜头中被说出,声音由视频模型生成。保存了嗓音的角色会用那条嗓音说话。

一个镜头能有多长?+

5 到 15 秒。一集是最多 50 个镜头的合成,全部同尺寸且不超过 7 天。

能做中文或日文短剧吗?+

能。把 language 设为 zh、ja 或其他代码,并用该语言写台词。标签适用于任何名字。

能只改一个镜头而不重做整集吗?+

能。渲染该镜头的新版本,然后用新 id 替换原位置,再次合成镜头清单。合成免费。

有分镜工具吗?+

演练场把分镜保存为项目,你也可以用 POST /v1/videos/projects 和自己的 JSON 在代码里做同样的事。

AI 智能体能替我制作剧集吗?+

能。把本页的提示词复制到 Claude Code、Cursor 或 Codex:智能体会阅读 Markdown 文档、起草镜头清单,并用你的密钥生成镜头和合成。

想用同一批角色做歌手的音乐视频,见音乐视频;想把你的演员放进已有的素材,见角色替换,或者注册并获取密钥。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。