

要点
- 赋予模型角色、字数、语气和输出格式。每一项缺失都会导致模型猜测。
- 短脚本一次调用即可。长脚本需要先写大纲,然后逐幕调用。
- 草稿阶段使用约 0.8 的 temperature,修改时调低;如果需要硬性结束,请设置停止序列。
- 100,000 token 的上下文窗口可以容纳完整大纲以及所有之前的幕,因此你很少需要技巧。
无需绑卡。注册后,一键领取 $0.50 免费试用额度(每人限领一次)。
获取 API 密钥简短回答:提示词包含五个部分
大多数弱脚本源于弱提示词。像“写一个关于咖啡的脚本”这样的请求会让模型自行选择长度、语气、格式和观点。改为提供以下五个部分:
- 目的: 观众在结束时应该感受或做什么。
- 受众和语气: “新手父母,温暖且略带疲惫”比“友好”效果更好。
- 长度: 以词为单位,因为模型计算词比计算秒更准确。大约 150 词等于一分钟的语音。
- 格式: 剧本、双栏配音和视觉说明,或纯旁白。
- 约束: 需要避免的内容、需要保留的名字、必须包含的最后一行。
以下是实际操作中的区别。一个较弱的提示词:“写一个关于睡眠的脚本。”一个更强的提示词:“为一段 50 秒的视频写一段 120 字的旁白,说服办公室职员停止在床上看邮件。语气:温和,略带幽默。以一个问题开头。以今晚可以采取的一个具体行动结束。不要提到药物。”第二个提示词多消耗约四十个 token,并去除了大部分修改轮次。将这些额外的词视为你曾经做过的最便宜的编辑。
这就是整个方法。页面的其余部分展示了如何将其转化为 API 调用,以及在脚本较长时如何扩展它。如果你只需要快速测试,API 密钥页面 为新账户提供少量试用额度。
选择一种格式并明确说明
模型会复制你展示的格式。如果你想要双栏脚本,请展示一行。提示词中的一小段示例胜过一段描述。
curl https://api.aivideogenapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"temperature": 0.8,
"messages": [
{"role": "system", "content": "You are a scriptwriter. Output a two-column script. Format each row as: VISUAL | NARRATION. About 150 words of narration in total. No headings."},
{"role": "user", "content": "Topic: why airports smell the way they do. Tone: wry. Audience: adults who travel for work."}
]
}'
一旦基础 URL 为 https://api.aivideogenapi.com/v1,相同的请求可与任何 OpenAI 客户端配合使用。有关身份验证和字段的详细信息请参阅文档。
对于对话脚本,在提示词中命名说话者,并为每个说话者提供一行声音说明(“Mara:直截了当,句子简短。Ilya:过度解释”)。如果没有这些,角色在第二页往往听起来相似。
改变结果的设置
少数参数比其他参数更重要。
| 参数 | 用于 | 典型值 |
|---|---|---|
temperature | 措辞的多样性 | 草稿 0.7 到 0.9,修改 0.3 到 0.5 |
top_p | 过滤不太可能的词 | 0.9 到 0.95;更改此值或 temperature,不要同时更改两者 |
max_tokens | 回复长度的硬性上限 | 可选;当你希望防止输出失控时设置 |
stop | 以标记结束 | 例如“END SCENE” |
frequency_penalty | 减少重复短语 | 长脚本 0.2 到 0.5 |
seed | 可重复的草稿 | 任何整数 |
这些参数会传递给模型。即使提示词只更改一个词,也不要期望从相同的种子获得相同的输出。
短脚本:一次调用即可
30 到 90 秒的脚本只有几百个词。发送包含五个部分的单个请求并请求单个草稿。然后使用第二条消息进行修改,因为修改草稿比从头重新生成效果更好。
from openai import OpenAI
client = OpenAI(base_url="https://api.aivideogenapi.com/v1", api_key="YOUR_KEY")
messages = [
{"role": "system", "content": "You write tight scripts for short videos. Plain narration, no stage directions."},
{"role": "user", "content": "Purpose: make viewers check their router settings. Tone: calm, a little amused. Length: 140 words."},
]
draft = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.8)
text = draft.choices[0].message.content
messages += [
{"role": "assistant", "content": text},
{"role": "user", "content": "Keep the structure. Replace the opening line with a question, and cut the last sentence."},
]
final = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.4)
print(final.choices[0].message.content)
注意第二次调用时 temperature 的下降。修改应遵循指令,而不是探索。如果你想观看脚本的生成过程,添加 stream: true 并在每个块到达时打印;API 用量会在流结束时显示。流式请求会占用一个并发槽位,直到完成,这在并行运行多个草稿时很重要。完整密钥允许同时运行 8 个。
长脚本:先大纲,后分幕
一次性要求 4,000 词会导致中间部分塌陷:模型会匆忙结束、重复想法并忘记小事实。更好的模式包含三个步骤。
步骤 1:大纲
请求一个编号大纲,每场戏一句话,每场戏的目的以及必须保持一致的事实列表(名字、地点、每个角色知道的内容)。手动编辑此大纲。这是修复故事最便宜的地方。
步骤 2:逐幕进行
对于每一幕,发送大纲、风格规则、之前幕的简短摘要以及上一幕的完整文本。只请求下一幕。
acts = []
summary = "None yet."
for n, goal in enumerate(outline_acts, start=1):
prompt = (
f"Outline:\n{outline_text}\n\nStory so far (summary): {summary}\n"
f"Previous act, full text:\n{acts[-1] if acts else '(none)'}\n\n"
f"Write act {n}: {goal}. About 600 words. Match the voice of the previous act."
)
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "system", "content": STYLE_RULES}, {"role": "user", "content": prompt}],
temperature=0.8,
)
acts.append(r.choices[0].message.content)
summary = summarize(acts) # one more short call
步骤 3:通读
发送完整脚本并请求列出矛盾和重复的行,而不是重写。通过针对性编辑修复这些问题。
使用 100,000 token 的上下文窗口
提示词加回复可达 100,000 token,约 70,000 字。完整的剧本大纲、风格指南以及长片剧本的每一幕都能舒适地容纳在上下文窗口中。这意味着你通常可以跳过摘要,直接发送到目前为止的整个故事,从而保留细节。
两个注意事项。首先,成本会增长,因为每次调用都会重新发送历史记录。其次,非常长的提示词仍然最好在结尾处包含最重要的指令,靠近请求。将当前任务放在最后,放在参考资料之后。上下文窗口 页面更深入地介绍了如何安排长输入。
检查逐幕构建的 10 分钟脚本的价格:假设调用总计 6,000 个输入 token 和 4,000 个输出 token。输入费用为 6,000 / 1,000,000 x $0.15 = $0.0009,输出费用为 4,000 / 1,000,000 x $0.50 = $0.002,总计 $0.0029。价格列在 定价页面上。
常见问题及解决方法
- 脚本太长或太短。 说明一个词范围并添加停止点。在代码中检查词数,并要求按确切数量修剪。
- 每个场景都以相同的方式开始。 添加频率惩罚,并添加一行提示词,如“改变场景的开头方式;不要有两个场景都以声音或天气细节开头。”
- 语气漂移。 将目标声音的两行示例粘贴到系统消息中,并告诉模型它们是风格参考,而不是要重复的文本。
- 舞台指示混入了旁白。 要求使用单独的字段(JSON 模式,
response_format设置为json_object),使旁白和视觉描述永远不共用字符串。 - HTTP 429。 你触发了限制。代码
rate_limited表示每分钟请求过多,concurrency表示同时请求过多。等待并重试。
更多指南
问答
每分钟视频应该要求多少词?
按平稳语速计划,每分钟约 150 个口语字数。快节奏的社交媒体片段可能达到 170 或更多,因此请使用真实配音进行测试。
我应该在一个请求中生成整个脚本吗?
对于大约 800 字以内的脚本,可以。对于更长的脚本,先写大纲,然后逐幕生成,每次传递大纲和上一幕的内容。
模型在请求之间会保留记忆吗?
不会。每个请求都是独立的,因此你需要在消息列表中发送你希望它看到的历史记录。
它能写黑暗或成人向的小说脚本吗?
该模型经过调整,可在合法成人用途下无内容审查地回答。涉及未成年人的性内容始终不允许。
只差一张表单,即可获得密钥
创建账户,复制密钥,更改基础 URL。这就是全部设置。