creatok-generate-video

動画生成

制約

• プラットフォーム：TikTok のみ。
• モデルのユーザー向け最終応答は、ユーザーの入力言語に合わせます。デフォルトは英語です。
• 有料または高コストの動画生成を呼び出す前に、必ずユーザーの確認を求めてください。
• 確認を得た後、CreatOK Open Skills プロキシを呼び出し、完了するまで待機してください。
• デバッグや開発者への共有に必要だとユーザーが明示した場合を除き、ユーザー向けの返信では技術的な表現を避けてください。
• ./references/common-rules.md の共通ガイダンスに従ってください。
• ユーザーが実写撮影版を明示的に求めない限り、モデルは人間の撮影プランを準備するのではなく、AI 動画の生成が目的だと想定してください。

モデル選択ルール

スキルは、モデル一覧、デフォルト、ハードリミットをローカルにハードコードするのではなく、実行時に CreatOK のケイパビリティエンドポイントから取得する必要があります。

ローカルクライアントは薄く保ってください。

• ユーザーが別の対応モデルを明示的に選択しない限り、返されたデフォルトモデルを使用します。
• 定義、長さ、向き、参照画像の上限など、実行に関するハード制約のみを検証します。
• ユーザー向けのモデル説明は最小限にし、プロバイダー、ファミリー、ヒント形式のメタデータに依存しないようにします。

選択したプランがモデルの制限と一致しない場合、モデルはその制限を説明し、実行可能なプランを提案して、生成前にユーザーの確認を待つ必要があります。

対応する定義、長さ、向き、参照画像の上限など、モデル一覧、デフォルト、ハードリミットは、このスキルにハードコードするのではなく、実行時に CreatOK のケイパビリティエンドポイントから取得する必要があります。 参照画像を使用する場合は、まずローカルの画像ファイルをアップロードし、アップロードした参照画像を動画タスクに渡します。

複数セグメントのルール

• 要求された動画の長さが選択したモデルの最大時間を超える場合、モデルは動画を複数のセグメントに分割するよう提案します。
• 最終動画を複数の生成済みクリップからつなぎ合わせる必要がある場合、モデルは後でユーザー自身がクリップを組み立てる必要があることを説明します。

確認する入力（不足している場合は質問）

• まず、良い動画の生成に必要な情報のうち、不足しているものだけを尋ねます。
• 会話の早い段階ですでに決まっている方向性、台本、セールスポイントを優先します。
• 情報が不足している場合は、最初から完全なブリーフを求め直すのではなく、短い追加質問を1つか2つ尋ねます。
• シーンの意図、ビジュアルスタイル、テンポ、製品の強調点、Sora 2 または Veo モデルのどちらを希望するかなど、AI 生成に直接役立つ情報を優先します。
• ツール呼び出しや引き継ぎの指示でモデル名を記載する場合は、別名ではなく正式なモデル ID をそのまま使用します。

ワークフロー

1. 確認ゲート（必須）

• 次の内容を要約します。
  • モデル
  • 向き
  • 選択したモデルに関係する場合は、定義と秒数
  • 参照画像を使用するかどうか
  • プランが単一ショットか複数セグメントか
  • 長さの上限、縦向きの必須要件、後で手動でつなぎ合わせる必要があることなど、重要な制限
  • 取得できる場合は、推定コスト／クレジット
• 今すぐ生成を開始するかどうかなど、平易な言葉で簡単な確認を求めます。
• ユーザーが「はい」と答えるまで、生成タスクを送信してはいけません。

2. 動画生成を送信

• CreatOK を呼び出します：POST /api/open/skills/tasks

3. 完了までステータスをポーリング

• CreatOK を呼び出します：GET /api/open/skills/tasks/status?task_id=...

4. 成果物を保存して返信

• 次のファイルを書き込みます。
  • outputs/result.json に task_id/status/video_url/raw を保存
  • outputs/result.md
• タスク ID を後でユーザーが復元できるよう、最終ステータスを待つ前に、送信後すぐ task_id を保存します。これにより、ローカルプロセスが中断されても復元できます。
• 最終的な video_url はそのまま返します。
• AI 版の完了後、モデルは必要に応じて、同じアイデアの実写撮影版も希望するかどうかを尋ねることができます。

既存タスクの再開

• ユーザーがすでに task_id を持っている場合、このスキルは新しいタスクを開始せず、そのタスクを引き継いで続行します。
• 再開モードでは、タスク ID がすでに利用可能な場合、ユーザーにプロンプトやクリエイティブブリーフを言い直すよう求めないでください。
• モデルは、次のいずれかを実行できます。
  • 現在のタスクのステータスを一度確認する
  • または、ユーザーが確認を続けたい場合は、待機してポーリングを続ける
• タスクが成功した場合は、最終的な video_url をそのまま返します。
• タスクがキューに入っているか実行中の場合は、その状況を明確に説明し、確認を続けるか尋ねます。
• タスクが失敗した場合は、失敗メッセージがあれば説明し、次善の手順を提案します。

成果物

すべての成果物は generate-video/.artifacts/<run_id>/... の下に保存されます。

シンクライアントの境界

• すでに creatok-analyze-video または creatok-recreate-video から得られたプロンプトやブリーフを優先して使用します。
• クリエイティブの方向性がまだ曖昧な場合、生成前に会話の中でモデルが内容を具体化できます。
• このスキルは生成ジョブを送信し、ステータスをポーリングして、固定形式の出力を保存します。
• 以前の会話ですでに方向性が明確になっている場合、モデルはユーザーにアイデアを最初から言い直させないでください。
• デフォルトでは、オンセット撮影ではなく、AI 動画生成に適したブリーフに整える必要があります。
• 「生成して」「動画を作って」「進めて」「このバージョンを使って」など、自然なユーザーの確認は、費用の確認手順を満たしている限り、このスキルを使う意図として扱います。

引き継ぎ

• creatok-analyze-video から引き継いだ場合、モデルはユーザーに繰り返しを求めず、選択済みの方向性を引き継ぐ必要があります。
• creatok-recreate-video から引き継いだ場合、モデルは会話ですでに作成されたスクリプトまたはブリーフを、生成の出発点として使用する必要があります。
• 送信後に生成が中断された場合、モデルはジョブを最初からやり直すのではなく、既存の task_id を使ってユーザーが creatok-generate-video 内で続行できるよう支援する必要があります。