

重點摘要
- 賦予模型角色、字數長度、語調與輸出格式。任何遺漏的項目都會變成猜測。
- 短腳本一次呼叫即可。長腳本需先撰寫大綱,然後逐幕呼叫。
- 草稿使用約 0.8 的 temperature,編輯時降低;若需硬性結束可設定 stop sequences。
- 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."}
]
}'
一旦 Base 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 | 可重複的草稿 | 任何整數 |
這些會傳遞給模型。不要期望在提示詞僅更改一個字的情況下,從相同 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)
注意第二次呼叫時的溫度變化。編輯應遵循指示,而非探索。如果你想觀看腳本逐塊出現,請加入 stream: true 並在每個區塊到達時將其輸出;用量總計會在串流結束時提供。一個串流請求會佔用一個並行槽位,直到它完成,這在你同時執行多個草稿時很重要。完整金鑰允許同時執行 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。這就是整個設定過程。