JA ▾
API キーを取得

ホームガイド

更新日:

AIにスクリプトを書かせる方法:プロンプトの構造

実際に撮影や音声収録ができるスクリプトをAIに書かせる方法を知りたい場合は、構造が鍵です。モデルに、スクリプトの対象者が誰か、どのくらいの長さか、出力の形状がどうあるべきかを指示します。

スクリプトページとクラッパーボードのスタックにリンクするノートタイルで、アウトラインファーストのスクリプトライティングを示しています
エージェントのコンテキストウィンドウを象徴する、光るブロックで満たされるガラス容器と、それを囲む矢印のループ

主要ポイント

  1. モデルに役割、単語数、トーン、出力形式を与えてください。不足している項目すべてが推測になります。
  2. 短いスクリプトは1回の呼び出しで収まります。長いスクリプトはまずアウトラインを作成し、その後で幕ごとの呼び出しを行います。
  3. 下書きには温度を約0.8に、編集には低い値に設定し、明確な終了が必要な場合はストップシーケンスを設定します。
  4. 100,000トークンのコンテキストウィンドウには完全なアウトラインとすべての過去のアクが含まれるため、技を使うことはほとんどありません。

カード不要。サインアップ後、ワンクリックで$0.50の無料テストクレジットを請求できます(1人1回限り)。

API キーを取得

短い答え:プロンプトには5つのパートが必要です

多くの弱いスクリプトは、弱いプロンプトに起因します。「コーヒーに関するスクリプトを書いて」というリクエストでは、モデルが長さ、声、形式、視点を決定することになります。代わりに以下の5つのパートを与えてください。

  1. 目的: 視聴者に最後に感じてもらいたいこと、または取るべき行動。
  2. オーディエンスとトーン: 「新規両親、温かみがあり少し疲れた様子」は、「フレンドリー」よりも効果的です。
  3. 長さ:単語数で指定します。モデルは秒数よりも単語数を正確にカウントします。約150語が1分間の音声に相当します。
  4. フォーマット: 脚本、2列のボイスオーバーと映像、または文章だけのナレーション。
  5. 制約:避けるべき事項、維持すべき名前、必須の最終行。

実際の違いを見てみましょう。弱いプロンプト:「睡眠に関するスクリプトを書いて」。より強力なプロンプト:「50秒の動画用の120語のナレーションを書いて、オフィスワーカーがベッドでメールをチェックするのをやめさせる内容にしてください。トーン:優しく、少しユーモアがある。質問で始める。今夜実行できる具体的なアクション1つで終わる。薬の言及は禁止」。2番目のプロンプトは約40トークン多く必要ですが、書き直しの手間を大幅に削減します。追加の単語を、これまでに経験した中で最も安価な編集として扱ってください。

これが全体の方法です。このページの残りの部分では、これをAPI呼び出しに変換する方法と、スクリプトが長い場合にスケーリングする方法を示します。クイックテストだけでよい場合は、APIキーページで新規アカウントに少量のトライアルクレジットを提供しています。

形式を選択して明示する

モデルは提示された形式をコピーします。2列のスクリプトが必要な場合は、1行の例を示してください。プロンプト内の小さな例が、説明文の段落よりも優れています。

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クライアントで機能します。認証とフィールドの詳細はドキュメントに記載されています。

対話スクリプトでは、プロンプトで話者を名乗り、各キャラクターに1行の音声メモ(「マラ:率直で短い文。イリヤ:説明過多」)を与えます。これがないと、2ページ目には登場人物の声が似てしまいます。

結果を変更する設定

いくつかのパラメータが他よりも重要です。

項目用途典型的な値
temperature表現の多様性下書き用は0.7〜0.9、編集用は0.3〜0.5
top_p可能性の低い単語を除外0.9から0.95;この値か温度のどちらかを変更し、両方同時に変更しないこと
max_tokens応答長のハードキャップオプション; runawayな出力を防ぎたい場合に設定
stopマーカーで終了例:「END SCENE」
frequency_penalty繰り返しのフレーズを削減長いスクリプト用は0.2〜0.5
seed繰り返し可能な下書き任意の整数

これらはモデルに渡されます。プロンプトを1語変更しただけでも、同じシードから完全に同じ出力が得られると期待しないでください。

短いスクリプト:1回の呼び出しで十分

30〜90秒のスクリプトは数百語です。5つのパートを含む1つのリクエストを送信し、単一の下書きを依頼してください。その後、編集用の2番目のメッセージを使用してください。下書きの編集は、最初から再生成するよりも効果的です。

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)

2回目の呼び出しで温度が下がることに注意してください。編集は指示に従うべきであり、探索すべきではありません。スクリプトが現れる様子を見たい場合は、stream: true を追加し、到着するたびに各チャンクを出力してください。使用量の合計はストリームの最後にあります。ストリーミングされたリクエストは完了するまで並行スロットの1つを保持するため、複数のドラフトを並行して実行する際には重要です。フルキーでは同時に8つまで許可されます。

長いスクリプト:まずアウトライン、その後幕

一度に4,000語を求めると、中央部が垂れ下がるようになります:モデルは結末を急ぎ、アイデアを繰り返し、小さな事実を忘れます。より良いパターンには3つのステップが必要です。

ステップ1:アウトライン

各シーンごとの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トークンウィンドウの使用

プロンプトと返信を合わせると100,000トークン、約70,000語に達します。完全なアウトライン、スタイルガイド、そして長編脚本のすべての完成した幕が余裕を持って収まります。つまり、要約を飛ばしてこれまでのストーリー全体を送ることで、小さな詳細をそのまま維持できることが多いのです。

2つの注意が必要です。第一に、各呼び出しが履歴を再送信するため、コストが増加します。第二に、非常に長いプロンプトでも、最も重要な指示がリクエストの直後に配置される場合に最も効果的です。参照資料の後に現在のタスクを最後に配置してください。長い入力の構成方法については、コンテキストウィンドウのページで詳しく説明しています。

10分のスクリプトの価格確認:アク構成で作成する場合、呼び出しの合計が6,000入力トークンと4,000出力トークンであると仮定します。入力は 6,000 / 1,000,000 x $0.15 = $0.0009、出力は 4,000 / 1,000,000 x $0.50 = $0.002 となり、合計で $0.0029 です。価格は料金ページに記載されています。

一般的な問題と修正

  • スクリプトが長すぎる、または短すぎる。 単語数の範囲を指定し、ストップポイントを追加します。コードで単語数をチェックし、正確な数字を指定して削減を依頼します。
  • 各シーンは同じ方法で始まります。 頻度ペナルティを追加し、「シーンの始まりを変化させ、決して2つのシーンを音や天気の詳細で開始しないこと」という行を追加します。
  • トーンが逸脱する。ターゲットの声のサンプル行2つをシステムメッセージに貼り付け、それらが再利用されるテキストではなくスタイルの参照であるとモデルに伝えてください。
  • 舞台指示がナレーションに混入する。 ナレーションと映像が同じ文字列を共有しないように、別々のフィールドを要求します(response_formatをjson_objectに設定したJSONモード)。
  • HTTP 429。制限に達しました。コードrate_limitedは1分あたりのリクエストが多すぎることを意味し、concurrencyは同時に多すぎることを意味します。待機して再試行してください。

質問と回答

動画1分あたりに何語のリクエストを送るべきですか?

穏やかなペースで1分あたり約150語を想定してください。速いソーシャルクリップでは170語以上になることもあるため、実際のボイスオーバーでテストしてください。

1回のリクエストでスクリプト全体を生成すべきですか?

800語程度以下なら、はい。より長いスクリプトの場合は、まずアウトラインを作成し、アクトごとに生成します。その際、アウトラインと最後の幕を毎回渡します。

モデルはリクエスト間で記憶を保持しますか?

いいえ。各リクエストは独立しているため、モデルに見せたい履歴をメッセージリストに含めて送信する必要があります。

ダークまたは大人向けフィクションのスクリプトを書くことができますか?

このモデルは、法的な成人向け利用に対してコンテンツ拒否なしで応答するように調整されています。未成年者を含む性的コンテンツは常に禁止されています。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。

API キーを取得