黑色星期五充值赠礼
每笔符合条件的充值都可获赠额度,并可与其他优惠叠加。
11月30日截止
交给你的 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>
工作方式
为剧集选角
搭建场景
用
POST /v1/scenes保存每个反复出现的地点——办公室、顶层公寓、医院走廊:一个名称、一段描述和一张图片。每个账户最多 100 个场景和 100 个角色。写镜头
每个镜头一次请求:提示词里用标签标出角色和场景,台词放在双引号里。每个被标记的角色都会成为一张参考图,所以面孔、发型、服装和房间都来自你的素材库,而不是提示词。镜头时长 5 到 15 秒。
剪出这一集
POST /v1/videos/joins把最多 50 个同尺寸的已完成镜头按顺序拼在一起,各自保留自己的声音,不收费。把这一集的镜头清单、角色和场景存进项目,方便随时回来继续。
几次请求做出一集
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 写成。
干这活儿的工具
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 让镜头可复现。
写出好用的镜头
图片承载面孔和服装,所以提示词只说发生了什么。不要描述角色长什么样,描述他们做什么。
大约一句台词加一个动作适合 5 到 8 秒的镜头。更长的讲话拆成两个镜头读起来更好。
对于必须接上的剪辑,把那一帧作为场景发送,并写 The shot opens exactly on @[Opening frame] as its first frame. 开场画面会紧密跟随它,尽管不是逐像素一致。
新服装就是新三视图:用 PATCH /v1/characters/{id} 更新角色,或把这套服装保存为独立角色。已经做好的视频保留它们当时用的三视图。
用你的密钥调用任何聊天模型,都能把一段梗概变成这种格式的编号镜头清单;渲染前由你审阅。
费用
镜头按渲染秒数计费:一张图片时每秒 $0.13,每多一张图片每秒加收 $0.06。模型按固定帧网格渲染,所以 5 秒的镜头按 5.17 秒计费,10 秒的镜头按 10.13 秒计费。一集一分钟、由六个 10 秒镜头组成、每个镜头两个角色加一个场景(三张图片),大约花费 $15.20。代词扫描的聊天调用按同一密钥上的普通聊天请求计费。角色、场景、嗓音、项目和合成免费。每个镜头在提交时从你的预付余额中预留,完成时扣费;失败和取消的镜头不收费。三视图和帧每张 $0.04。所有价格都在定价页。
条款与负责任使用
minimax-h3-video 受 MiniMax H3 条款约束:每个镜头都要设 consent: true 表示接受这些条款,其中包括不在欧盟、英国、韩国或美国使用该模型。使用你拥有或获准使用的面孔和嗓音;基于真人的演员阵容需要本人同意。可接受使用政策同样适用。完成的镜头和合成结果保留 7 天,所以每集做完就下载。
常见问题
角色在每个镜头里都长得一样吗?+
是的,这正是打标签的意义。每个被标记角色的三视图都是该镜头的参考图,所以面孔、发型和服装每次都来自它。不要在提示词里描述他们的长相。
角色能说话吗?+
能。把台词放在角色标签后面的双引号里,它就会在镜头中被说出,声音由视频模型生成。保存了嗓音的角色会用那条嗓音说话。
一个镜头能有多长?+
5 到 15 秒。一集是最多 50 个镜头的合成,全部同尺寸且不超过 7 天。
能做中文或日文短剧吗?+
能。把 language 设为 zh、ja 或其他代码,并用该语言写台词。标签适用于任何名字。
能只改一个镜头而不重做整集吗?+
能。渲染该镜头的新版本,然后用新 id 替换原位置,再次合成镜头清单。合成免费。
有分镜工具吗?+
演练场把分镜保存为项目,你也可以用 POST /v1/videos/projects 和自己的 JSON 在代码里做同样的事。
AI 智能体能替我制作剧集吗?+
能。把本页的提示词复制到 Claude Code、Cursor 或 Codex:智能体会阅读 Markdown 文档、起草镜头清单,并用你的密钥生成镜头和合成。