動画のウィジェットコード: バックグラウンドの動画ジョブが訪問者に届くまで
動画の生成には数秒ではなく数分かかります。動画ウィジェットのコードの裏側で、最初のリクエストから完成まで何が起きているか、その間に訪問者に何が表示されるかを解説します。
公開日:
チャットの回答は数秒でストリーミングされますが、生成される動画には数分かかることがあります。動画ウィジェットはこの違いを前提に作られているため、ジョブの実行中も訪問者にはわかりやすい体験を、あなたのアカウントには保護を提供します。
同じ1行のコード
すべてのウィジェットの種類で、同じ埋め込みコードを使います。
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
違いはサーバー側にあります。ウィジェットの種類が 動画 の場合、訪問者のプロンプトはすぐに結果を返すのではなく、ジョブを開始します。
ステップごとの流れ
- 訪問者がプロンプトを送信します。 リクエストはウィジェットIDとともにapi14に届きます。サーバーは、ページが許可したサイトのいずれかにあるかを確認し、上限を適用して、選んだモデルでジョブを開始します。
- ジョブIDが返ってきます。 ウィジェットは処理中の状態を表示します。ジョブIDはあなたのウィジェットに結びついており、別のウィジェットやIDを推測する人がそれを読み取ることはできません。
- ウィジェットが状態を確認します。 数秒おきに、動画ができたかどうかを問い合わせます。この確認は新しいプロンプトとは別にレート制限されるため、長いジョブでも訪問者のリクエスト枠を使い切ることはありません。
- 動画が再生されます。 ジョブが完了すると、ウィジェットはクリップをダウンロードして再生し、ダウンロード リンクを表示します。
生成に失敗した場合、訪問者にはあなたのエラーメッセージ (または中立的な既定のメッセージ) が表示され、原因はウィジェット一覧に表示されるので修正できます。
あなたが管理できること
- モデル: ウィジェット で選びます。ウィジェットは5秒に最も近い対応可能な長さと、720pに最も近い解像度をリクエストするため、クリップ単価が予測しやすく保たれます。
- APIキー: すべてのウィジェットは、エディターで選んだあなたのAPIキーのいずれかで動作します。リストの最後には 新しいAPIキーを作成 があります。ジョブはそのキーの下に記録され、キーの上限が適用されます。
- 見た目: タイトル、テキスト、アクセントカラー、テーマ、角の丸み、配置。ウィジェットはホワイトラベルです。
訪問者に内部は見えません
訪問者に見えるのは、あなたのテキスト、進行状況、完成した動画だけです。指示、残高、APIキー、提供元の生のエラーは、すべてサーバーに残ります。
モニタリング
ウィジェット一覧には、各ウィジェットの最終利用、今日の利用額、直近のエラーが表示されます。利用状況 ではリクエストをウィジェット別またはサイト別にまとめられ、失敗通知メールが、残高切れや削除されたモデルなど自分で解決できる問題を知らせてくれます。