UGC クリップ一覧

UGC クリップ一覧ノードは、UGC 動画のスクリプトをテイクごとのクリップに分けます。UGC スクリプトのスクリプトと UGC クリエイターのクリエイターを受け取り、スクリプトをもう一度確認します。各クリップは UGC クリップに渡され、そこでレンダリングされます。

動画のクリップの数は、動画の長さと行によって決まります。ノードには、クリップとそれぞれの長さが表示されます。このノードだけを実行すると、クリップとその後のステップにかかる料金も表示されます。

UGC クリップ一覧は Nodaro Cloud でのみ動作します。それ以外の環境では、すべての UGC ノードが、何も確保される前に「UGC 動画は Nodaro Cloud の機能のため、このインスタンスでは提供されていません。」というメッセージで失敗します。

使いどころ

• UGC スクリプトのスクリプトと UGC クリエイターのクリエイターがあり、動画をレンダリングしたい。
• クリップをレンダリングする前に、その料金を確認したい。
• クリエイターが話すボイスを選びたい。

クイックスタート

入力

出力

項目ごとに分かれて渡されるのはクリップだけです。ほかの 2 つの出力は、接続のモードにかかわらず、値を 1 つ渡します。接続モードを参照してください。

設定

スクリプトの再確認

UGC クリップ一覧は、スクリプトが動画のルールに沿っているか、もう一度確認します。スクリプトがルールに反するのは、UGC スクリプトで行を編集したときだけです。そのようなスクリプトは、クリップの料金がかかる前に、「スクリプトに修正が必要です：」に続けて各問題とその対処を示すメッセージで、UGC クリップ一覧を失敗させます。

ヘブライ語のスクリプト

ヘブライ語のスクリプトは、まず選んだボイスで 1 つの音声として録音されます。その単語のタイミングが取られ、音声は間の位置で分けられます。そのあと UGC クリップ一覧は、分けた部分ごとに 1 本のクリップを渡します。各クリップは最長 7 秒です。この 3 つのステップには、それぞれの料金がかかります。

録音は動画の長さの最大 1.2 倍までで、21 秒を超えることはありません。それより長い録音では、実行が分割の段階で「SPEECH_TOO_LONG … Shorten the script.」（…スクリプトを短くしてください）で止まります。分割の料金は返還されます。音声と単語のタイミングの料金は請求されたままです。UGC スクリプトは、動画の長さに対して長すぎるヘブライ語のスクリプトを、1 秒あたり 2.5 語で数えてあらかじめ書き直します。15 秒の動画では 45 語、最大でも 52 語です。

ヘブライ語のボイスは、Maya と Shira（女性）、Itai と Omer（男性）です。

ヘブライ語の動画のクリップをレンダリングする前に、UGC クリップ一覧は、分割で渡されたクリップの料金を、その後のステップとあわせて算出します。各クリップは、レンダリング中に確保する額で計算されます。UGC クリップ一覧は、その料金を、実行の開始前に残高と照らし合わせた額、つまりその動画の受け入れられるどの録音からも切り出せる最大数のクリップ分と比べます。クリップの確保額がそれを上回る場合、どのクリップもレンダリングされる前に、実行はここで止まります。音声、単語のタイミング、分割の料金は請求されたままです。ノードは「この録音のクリップは、この実行で確認した金額を超えるため、どのクリップもレンダリングしませんでした。「UGC クリップ一覧」をもう一度実行して、音声を録音し直してください。」というメッセージで失敗します。このチェック自体は無料です。

ヘブライ語の動画では、UGC クリップの後に UGC 仕上げを置き、UGC クリップ一覧のスクリプト（長さ調整済み）出力をそこに接続する必要があります。接続しないと、UGC クリップ一覧は何も使う前に「「UGC クリップ」の後に「UGC 仕上げ」ノードを追加し、「UGC クリップ一覧」の「スクリプト（長さ調整済み）」出力を接続してください。」というメッセージで失敗します。

クリップの料金

UGC クリップ一覧をノード自身の実行ボタンで実行すると、ノードにクリップの料金が表示されます。

• クリップの行： クリップごとに 1 行で、その長さが表示されます。
• ステップの行： クリップの後の各ステップごとに 1 行です。ステップは、ヘブライ語の動画でのクリップの仕上げ、クリップが複数ある場合のクリップの結合、単語のタイミング、話し声の確認、スクリーンショットカードがある場合はそのカード、そして字幕です。
• 見込み： 動画にかかる見込みの料金です。
• クリップのレンダリング中に保留： クリップのレンダリング中に実行が保留する額で、クリップの料金の約 2 倍です。

このように UGC ノードを 1 つずつ実行すると、クリップをレンダリングする前に金額を確認できます。ワークフロー全体を実行すると、そのままクリップに進むため、UGC クリップ一覧には金額が表示されません。その場合の料金は、実行の前に表示されます。エディターでの料金を参照してください。

クレジット

UGC クリップ一覧は無料です。表示される金額は、UGC クリップとその後のステップにかかる料金です。UGC クリップのクレジットを参照してください。

ヒント

• 先に料金を確認する。 UGC スクリプト、UGC クリエイター、UGC クリップ一覧を、それぞれ自身の実行ボタンで 1 つずつ実行すると、クリップをレンダリングする前に料金を確認できます。
• レンダリングの前にクリップの長さを確認する。 動画が長いほど、クリップは多くなります。
• 接続のモードはデフォルトのままにする。 クリップが個別モードなので、UGC クリップはクリップごとに 1 回実行されます。

トラブルシューティング

API から

UGC クリップ一覧は、実行時に POST /v1/ugc/clips を呼び出します。UGC のルートのリクエストとレスポンスの形はノードのためのもので、バージョンによって変わる場合があります。コードから UGC 動画を作るには、UGC ノードを含むワークフローか公開したアプリを実行してください。ワークフローを参照してください。

POST /v1/ugc/quote は、UGC 動画の料金を算出します。無料で、何も確保されず、1 分あたり 30 回まで呼び出せます。形式は 2 つあります。

• チケット： { "tickets": [ … ], "hasCards": true } は、UGC クリップ一覧が渡した 1〜11 本のクリップの料金を、UGC クリップとその後のステップでかかる額として算出します。これが UGC クリップ一覧に表示される金額です。
• 見積もり： { "estimate": { "targetDurationSec": 15, "screenshotCount": 3, "source": "sampled" } } は、何かを実行する前に、スクリプトとクリエイターを含む動画全体の料金を算出します。targetDurationSec は 4〜300 です。screenshotCount は 0〜8 で、1 と 2 は 0 として算出されます。source は sampled（AI クリエイター）または photo です。任意の rendersEveryCandidate を指定すると、エディターでの実行と同じく、すべてのクリエイター候補の料金を算出します。

チケットの形式は、任意のフィールドを 2 つ受け付けます。

• finishes: true は、ヘブライ語の動画のように、クリップが UGC 仕上げのジョブを通ることを示します。その場合、答えには「クリップの仕上げ」の行（キー finish）が含まれ、1 回だけ課金されます。結合の行（キー join）は、テンプレートの結合ノードの課金と同じように算出されます。つまり、その設定で、各クリップを「動画を結合」の標準の 8 秒の長さとして計算します。クリップは、クリップの長さを持たない 1 つのリストとして結合ノードに届くためです。
• runEstimate は、クリップが属する動画の見積もりの入力（targetDurationSec、screenshotCount、source、language）です。その場合、答えには runHold も含まれます。これは、その動画の見積もりがクリップとその後のステップのために確保する最大額で、同じ hasCards と finishes で算出されます。

どちらの形式も、lines（それぞれ英語の label、credits、固定の key を持つ）、expected、ceiling（クリップのレンダリング中に動画が保留する額）、parts、holdParts を返します。見積もりは、長さを 0.8 倍と 1.2 倍にしたときの見込みの料金である range と、worstCase も返します。料金を算出できない項目があると、422 unpriceable が返ります。UGC のルートが提供されていない環境では、このルートは 503 not_available を返します。

ヘブライ語の動画（見積もりで language: "he"）では、録音した音声によってクリップの数が決まるため、見積もりには 0.8 倍と 1.2 倍の実行がありません。expected と ceiling は、音声に必要と見込まれるクリップの分です。range は、そうした音声に通常必要な最大数のクリップの分までです。worstCase には、受け入れられるどの録音を切り分けた場合でも最も高くなる切り分け方が、各クリップの料金の 2 倍で入ります。録音は目標の長さの最大 1.2 倍までで、21 秒を超えることはありません。15 秒の動画では 18 秒、17.5 秒以上の動画では 21 秒です。そのため、最悪の場合の額は目標の長さとともに増え、最長 7 秒のクリップ 6 本までになります。音声、単語のタイミング、分割、仕上げは、それぞれ独立した行で、1 回ずつ課金されます。

ヘブライ語の動画のクリップをレンダリングする前に、UGC クリップ一覧は runEstimate を付けてチケットの形式に問い合わせ、分割で渡されたクリップの料金を算出します。これは、エディターでも、公開したアプリでも、API での実行でも同じです。クリップの ceiling が runHold を上回る場合、または金額を得られない場合、どのクリップもレンダリングされる前に、実行は UGC クリップ一覧で止まります。