JA ▾

Unfiltered Video API Text: スクリプト用のLLMワークフロー

「無検閲の映像APIテキスト」で検索したなら、有用な分割はこれです:レンダラーがピクセルを生成し、テキストLLM APIがスクリプトやショットリストからキャプション、説明文までを生成します。このガイドはOpenAI互換エンドポイントでテキスト側を構築します。

更新

ターミナル内で流れるテキストブロックに変化するフィルムストリップ。映像用のLLMテキストワークフローを示すイラスト。

主要ポイント

  • APIはテキストのみです。スクリプト、ショットリスト、字幕、説明文を生成しますが、映像、画像、音声のレンダリングは行いません。
  • ストリーミングにより、執筆中にスクリプトのドラフトが取得できます。JSONモードにより、コードで解析可能なショットリストが得られます。
  • 100,000トークンのウィンドウは、1つのリクエストで長いトランスクリプトと指示を保持します。
  • 1つの動画の全文処理には、100万トークンあたり入力$0.15、出力$0.50で、1セントにも満たない費用です。

テキストが動画パイプラインで果たす役割

当サイトのAPIは映像を生成しません。テキストのみで、画像、音声、映像の出力、埋め込み、ファインチューニングはありません。この点は重要です。このフレーズは2つの意味で解釈されるためです。映像クリップをレンダリングするモデルを求めている人もいれば、すでにレンダラー、ストックライブラリ、エディターを持っており、法的ではあるが不快な題材(ホラー脚本、真実の犯罪再現、ダークコメディ、戦争ドキュメンタリーのナレーション、大人向けのフィクション)に対して拒否せずにテキストを記述するLLMを求めている人がいます。

2番目のグループがこの記事の対象です。実際、映像を取り巻くテキスト作業は4つのタスクに分類されます。

  • 脚本のドラフト作成 概要やメモの山を、一貫した声のナレーションに変換します。
  • ショットリスト スクリプトを、持続時間、視覚的説明、ナレーションの1行を含むシーンに分割し、編集コードが読み込めるJSON形式で出力します。
  • キャプションと字幕のクリーンアップ 生トランスクリプトの句読点や話者ラベルを修正するか、画面に表示するテキストを生成します。
  • タイトル、説明文、タグ。 短く、かつ大量の出力が必要となるため、トークン単位の課金体系が有利に働きます。

エンドポイントの背後にあるモデルは、独立したプロバイダーが運用する1つのオープンウェイトモデルで、法的な大人向け利用に対してコンテンツ拒否なしで回答するようにチューニングされています。ベンダー間のルーターではなく、他社の公式APIでもありません。適用される1つの厳格な制限は、未成年者を含む性的コンテンツは禁止という点です。オーディオとビデオの両側がどのように連携するかまだ検討中なら、動画パイプラインに関するページで役割分担を確認してください。

クライアントを接続

このエンドポイントはOpenAIのチャット補完形式に対応しており、Base URLとAPI キーの2つの値を変更するだけで、あらゆるOpenAI SDKがそのまま置き換え可能です。モデルIDはuncensoredで、認証は標準的なBearerトークンを使用します。利用可能なメソッドは2つあります:POST /v1/chat/completionsとGET /v1/modelsです。

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

# sanity check: the model list should include "uncensored"
print([m.id for m in client.models.list().data])
MODEL = "uncensored"

シェルを好む場合は、同じ確認リクエストは1回で済みます:

curl https://api.unfilteredvideo.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a two-line cold open for a ghost-story video."}]}'

キーは APIキーページ で取得できます。新規アカウントは1クリックで$0.50の無料トライアルクレジットを取得でき、7日間有効でカード不要です。これは以下のすべての作業に十分な量です。

ステップ1:スクリプトのドラフトをストリーミング

スクリプトはパイプラインで最も長い出力となるため、ストリーミングする価値があります。stream: true を指定すると、サーバーは生成されるたびにトークンをSSE経由で送信し、使用状況はストリームの最後に届きます。編集ツールは、生成全体が完了するまでフリーズするのではなく、ドラフトが成長していく様子を表示できます。

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

outline = """Cold open: abandoned lighthouse at night.
Act 1: the keeper's logbook, last entry torn out.
Act 2: the tide table that does not match the moon.
Close: the lamp turns on by itself."""

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.9,
    messages=[
        {"role": "system", "content": "You write narration for short horror videos. Second person, present tense, about 90 seconds spoken."},
        {"role": "user", "content": outline},
    ],
)

script = []
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        piece = chunk.choices[0].delta.content
        script.append(piece)
        print(piece, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\n\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

script = "".join(script)

見落としがちな2つの詳細があります。まず、最後のチャンクには使用量が含まれますがchoicesは含まれないため、インデックスアクセス前にchunk.choicesをチェックします。第二に、ストリーミングリクエストはストリームが終了するまで同時実行数のスロットを保持します。ツールがユーザーに複数のドラフトを同時に開始させる場合、開いているストリームごとに制限をカウントしてください。

声はシリーズ全体で逸脱しがちです。チャンネルのルールをシステムメッセージに設定し、固定してください:ナレーターの人称と時制、文の長さ、避けるべき単語、コールドオープンの終わり方など。脚本が絶対にやってはいけないことの短いリストを追加します(例:どんでん返しを早い段階で説明することなど)。安定したシステムメッセージは、動画間でトークン数を予測可能にし、後で予算を組む際に役立ちます。

プロンプトを調整しながら再現可能なドラフトを作成するには、固定値の seed と低い temperature を渡します。最初のクリエイティブな下書きには、0.8〜1.0程度のtemperatureがより自由で生き生きとしたナレーションをもたらし、推敲段階では値を下げることもできます。

ステップ2:スクリプトをショットリストに変換

編集コードは段落ではなく構造を必要とします。JSONモードはモデルに単一のJSONオブジェクトを返させます。これは response_format で有効化します。また、プロンプトに「JSON」という単語を含め、望む形状を記述してください。この2つを組み合わせることで、出力の形状が維持されます。

import json, os
from openai import OpenAI

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

def shot_list(script_text):
    resp = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.3,
        messages=[
            {"role": "system", "content": (
                "Return JSON only: {\"shots\": [{\"n\": int, \"seconds\": number, "
                "\"visual\": string, \"narration\": string}]}. "
                "Keep each shot between 3 and 8 seconds."
            )},
            {"role": "user", "content": script_text},
        ],
    )
    data = json.loads(resp.choices[0].message.content)
    return data["shots"]

for s in shot_list(script):
    print(s["n"], s["seconds"], s["visual"][:60])

JSONモードは不正な出力を完全に排除するわけではありません。json.loadsをtryブロックで囲み、温度を低くして1回リトライし、依存するフィールドを検証してください。secondsの値が欠如したショットリストは、少し不器用な文よりもタイムラインを大きく破綻させます。

visualの文字列を、フッテージを生成または選択するツールに渡します。モデルは題材について慎重になるよう求められていないため、重厚または緊張感のあるシーンの説明は、丁寧な拒否ではなく、書かれた指示書として返されます。公開するものについては、ループ内に独自のレビューステップを保持してください。

ステップ3:長いトランスクリプトから字幕と説明文を生成

コンテキストウィンドウは100,000トークン(プロンプトと補完の合計)。動画のテキスト作業には十分です:長いインタビューの文字起こし、チャンネルのスタイルガイド、3つの例説明文を1つのリクエストに収められます。小さなウィンドウで必要だったチャンク化と結合が不要です。実際のサイズはusageフィールドから確認し、出力分の余地を残してください。

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.unfilteredvideo.com/v1",
});

const transcript = fs.readFileSync("interview.txt", "utf8");

const res = await client.chat.completions.create({
  model: "uncensored",
  temperature: 0.4,
  messages: [
    { role: "system", content: "You write video metadata. Reply with a title under 70 characters, a 3 sentence description, and 8 tags separated by commas." },
    { role: "user", content: transcript },
  ],
});

console.log(res.choices[0].message.content);
console.log(res.usage);

字幕のクリーンアップには、サイズではなく時間で分割してください。タイムスタンプをそのまま維持する指示とともに、生のトランスクリプトを数分ごとに送信し、その後結合します。ハウススタイルに一致する画面表示字幕も必要な場合は、スタイルルールをシステムメッセージに設定し、呼び出し間で同一に保ってください。これにより出力の一貫性が保たれ、トークン数が予測可能になります。

ツール呼び出しも利用可能です。例えば、ショットリストを記述しながら映像ライブラリで一致するクリップを探す lookup_asset 関数をモデルに呼び出させたい場合などです。ツールを定義し、返信から tool_calls を読み取り、それを実行し、結果を role: "tool" メッセージとして送信します。

パイプラインを制約する制限事項

通常キーでは同時8リクエスト、1分あたり300リクエストが可能です。トライアルキーでは同時2リクエスト、1分あたり60リクエストです。ボディの上限は8 MBで、テキストとして送信するトランスクリプトのいずれよりもはるかに余裕があります。制限を超えると、HTTP 429エラー(1分あたりのリクエスト数が多すぎる場合はrate_limited、同時接続数が多すぎる場合はconcurrency)が返されます。一時的な過負荷時には、Retry-After: 5ヘッダー付きの429も返されます。

シンプルなルール:429が発生した場合は、ヘッダー値があればそれを待ち、なければ数秒間バックオフしてから再試行してください。失敗または拒否されたリクエストは課金されないため、再試行にコストはかかりません。レスポンスにはサポート質問用の X-Request-Id と、ツール内で残高クレジットを表示するのに便利な X-Balance-USD が含まれます。

複数の動画を並列にレンダリングする際は、テキスト工程に4〜6の小さなワーカープールを割り当て、ドラフトのバーストがショットリスト工程を飢えさせないようにしてください。ストリームは開いている間ずっと同時実行数のカウント対象となるため、ドラフトの読み込み中に離脱したユーザーでも、完了するまでスロットを保持し続けます。

1本の映像のテキスト部分の費用

価格は、100万入力トークンあたり$0.15、100万出力トークンあたり$0.50で、前払いクレジットから課金され、サブスクリプションはありません。90秒の動画に対する現実的なテキスト生成の計算は以下の通りです:

ステップ入力トークン出力トークンコスト
スクリプトのドラフト6001,200600 × $0.15/1M = $0.00009、1,200 × $0.50/1M = $0.0006、合計 $0.00069
ショットリスト1,500900$0.000225 + $0.00045 = $0.000675
タイトル、説明文、タグ1,800300$0.00027 + $0.00015 = $0.00042

3つのステップで動画あたりのコストは$0.001785です。テキスト生成コストは1,000本の動画で$1.785です。実際のプロンプトがこれより3倍長くても、テキスト生成は低コストです。$0.50の無料トライアルクレジットだけで、これらのサイズなら250本以上の動画がカバーできます($0.50 ÷ $0.001785 ≈ 280本)。

トライアル終了後、クレジットは$20〜$500の任意の整数額のチャージから得られ、暗号資産(TRC20上のUSDTまたはBase上のUSDC)で支払います。大口チャージにはボーナスが付与されます:$50から+5%、$100から+10%、$200から+15%。クレジットは期限切れにならず、プロンプトはトレーニングに使用されません。詳細は価格ページに記載されており、クイックスタートには他の言語での同じリクエスト形式が記載されています。

質問と回答

このAPIは映像を生成できますか?

いいえ。テキストのみで、画像、音声、映像の生成はありません。スクリプト、ショットリスト、字幕、説明文の作成に使用し、お好みのレンダラーやエディターと組み合わせてください。

ダークな題材や大人向けの内容を拒否しますか?

モデルは法的な大人向け利用に対してコンテンツ拒否なしで回答するようにチューニングされているため、ホラー、犯罪、大人向けフィクションは処理可能です。未成年者を含む性的コンテンツは厳格に禁止です。

どのモデルIDとBase URLを使用すればよいですか?

モデルIDに uncensored を、Base URL に https://api.unfilteredvideo.com/v1 を使用し、OpenAI互換のSDKで動作します。Bearerトークンで認証してください。

無料プランはありますか?

無料プランはありません。新規ユーザーはカードなしで7日間有効な1回限りの$0.50無料トライアルクレジットを取得できます。その後、$20からチャージしてください。

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

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

API キーを取得