Sora 動画生成スキル
プロジェクト向けのショート動画クリップ(製品デモ、マーケティングスポット、映画的なショット、UIモックなど)を作成・管理します。デフォルトはsora-2モデルと構造化プロンプト拡張ワークフローを使用し、決定論的な実行のためにバンドルされたCLIを優先します。注: $soraはプロンプト内のスキルタグであり、シェルコマンドではありません。
使用タイミング
- プロンプトから新しい動画クリップを生成する場合
- 既存の動画をIDでリミックスする場合
- ステータスのポーリング、ジョブ一覧、アセット(動画/サムネイル/スプライトシート)のダウンロードを行う場合
- バッチ実行(多数のプロンプトやバリエーション)の場合
決定ツリー(作成 vs リミックス vs ステータス/ダウンロード vs バッチ)
- ユーザーが動画IDを持ち、変更を希望する場合 → リミックス
- ユーザーが動画IDを持ち、ステータスやアセットを希望する場合 → ステータス/ポーリング/ダウンロード
- ユーザーが多数のプロンプト/アセットを必要とする場合 → create-batch
- ユーザーが小さな変更で2つのバージョンを要求する場合(同じショット、異なる被写体/詳細) → ベースを作成し、バリエーションをリミックスする
- その他の場合 → 作成(または1ステップで準備完了アセットが必要な場合はcreate-and-poll)
ワークフロー
- 意図を決定する: 作成 vs リミックス vs ステータス/ダウンロード vs バッチ
- 入力を収集する: プロンプト、モデル、サイズ、秒数、入力参照画像(ある場合)
- バッチの場合:
tmp/以下に一時的なJSONLファイルを書き込む(1行1ジョブ)、1回実行した後、JSONLを削除する - 事前に構造化プロンプトを記述する代わりに、CLIの拡張フラグ(
--use-case、--scene、--cameraなど)を優先する。すでに構造化プロンプトファイルを作成している場合は、--no-augmentを渡して二重ラップを避ける - バンドルされたCLI(
scripts/sora.py)を適切なデフォルトで実行する(references/cli.md参照)。長いプロンプトの場合は、シェルエスケープの問題を避けるために--prompt-fileを優先し、プロンプトがすでに構造化されている場合は--no-augmentを組み合わせる - 非同期ジョブの場合は、完了するまでポーリングする(またはcreate-and-pollを使用する)
- アセット(動画/サムネイル/スプライトシート)をダウンロードし、ローカルに保存する
- 呼び出し中に作成された中間ファイルを削除する(例:
prompt.txt、remix_job.json、一時JSONL)。サンドボックスがrmをブロックする場合は、クリーンアップをスキップするか、エラーを表示せずにファイルを空にする - プロンプトごとに1つの対象を変えて反復する
認証
- ライブAPI呼び出しには
OPENAI_API_KEYが設定されている必要があります。
キーがない場合、ユーザーに以下の手順を案内してください:
- OpenAIプラットフォームUIでAPIキーを作成: https://platform.openai.com/api-keys
- システムの環境変数として
OPENAI_API_KEYを設定する - 必要に応じて、OS/シェルに合わせた環境変数の設定方法を案内する
- チャットで完全なキーを貼り付けるようユーザーに依頼しないでください。ローカルに設定し、準備ができたら確認を求めてください。
デフォルトとルール
- デフォルトモデル:
sora-2(高忠実度にはsora-2-proを使用) - デフォルトサイズ:
1280x720 - デフォルト秒数:
4(許容値: "4"、"8"、"12" の文字列) - サイズと秒数は常にAPIパラメータで設定します。文章では変更されません
- OpenAI Python SDK(
openaiパッケージ)を使用します。生のHTTPは使用しません - ライブAPI呼び出しの前に
OPENAI_API_KEYを必要とします - uvキャッシュの権限に失敗した場合、
UV_CACHE_DIR=/tmp/uv-cacheを設定します - 入力参照画像はjpg/png/webp形式で、ターゲットサイズと一致する必要があります
- ダウンロードURLは約1時間で期限切れになります。アセットは自分のストレージにコピーしてください
- バンドルされたCLIを優先し、ユーザーが明示的に依頼しない限り
scripts/sora.pyを変更しないでください - Soraは音声を生成できます。ユーザーがナレーションや音声を要求した場合、
Audio:およびDialogue:行で明示的に指定し、短く保ちます
API制限
- モデルは
sora-2とsora-2-proに制限されています - SoraモデルへのAPIアクセスには、組織確認済みのアカウントが必要です
- 動画の長さは4/8/12秒に制限されており、
secondsパラメータで設定する必要があります - APIは
secondsを文字列列挙型("4"、"8"、"12")として期待します - 出力サイズはモデルによって制限されます(サポートされているサイズは
references/video-api.mdを参照) - 動画作成は非同期です。ダウンロード前に完了をポーリングする必要があります
- レート制限は使用階層によって異なります(具体的な制限は列挙しないでください)
- コンテンツ制限はAPIによって適用されます(下のガードレールを参照)
ガードレール(必ず遵守)
- 18歳未満の視聴者に適したコンテンツのみ
- 著作権で保護されたキャラクターや音楽は使用不可
- 実在の人物(公人を含む)は使用不可
- 人間の顔を含む入力画像は拒否されます
プロンプト拡張
プロンプトを構造化されたプロダクション向け仕様に再フォーマットします。暗黙の詳細のみを明示的にし、新しいクリエイティブ要件を考案しないでください。
テンプレート(関連する行のみを含める):
Use case: <クリップの使用場所>
Primary request: <ユーザーのメインプロンプト>
Scene/background: <場所、時間帯、雰囲気>
Subject: <メインの被写体>
Action: <単一のはっきりしたアクション>
Camera: <ショットタイプ、アングル、動き>
Lighting/mood: <照明 + ムード>
Color palette: <3-5のカラーアンカー>
Style/format: <映画/アニメーション/フォーマットの手がかり>
Timing/beats: <カウントまたはビート>
Audio: <アンビエントキュー / 音楽 / ナレーション(要求された場合)>
Text (verbatim): "<正確なテキスト>"
Dialogue:
<対話>
- Speaker: "短いセリフ。"
</対話>
Constraints: <必ず維持/避けること>
Avoid: <否定的な制約>
拡張ルール:
- 短く保ち、ユーザーがすでに暗示または他の場所で提供した詳細のみを追加します
- リミックスでは、不変条件を明示的にリストします(「同じショット、Xのみ変更」)
- 成功を妨げる重要な詳細が欠けている場合は質問します。それ以外は進めます
- 構造化プロンプトファイルをCLIに渡す場合は、ツールによる再ラップを避けるために
--no-augmentを追加します
例
生成例(単一ショット)
Use case: 製品ティーザー
Primary request: マットブラックのカメラが台座に載っているクローズアップ
Action: 4秒間で30度のスローオービット
Camera: 85mm、浅い被写界深度、優しい手持ちドリフト
Lighting/mood: ソフトなキーライト、繊細なリムライト、プレミアムスタジオの雰囲気
Constraints: ロゴなし、テキストなし
リミックス例(不変条件)
Primary request: 同じショットとフレーミング、パレットをティール/サンド/ラストに変更し、暖かいバックライトを追加
Constraints: 被写体とカメラの動きは変更しない
プロンプトのベストプラクティス(短いリスト)
- ショットごとに1つのメインアクション + 1つのカメラムーブ
- タイミングにはカウントまたはビートを使用(「2歩、ポーズ、ターン」)
- UIや画面上のテキストには、テキストを短くしカメラを固定する
- アーティファクト(フリッカー、ジッター、速い動き)が現れた場合、簡単な回避行を追加する
- 短いプロンプトはより創造的、長いプロンプトはより制御的
- ダイアログは専用ブロックに配置し、4-8秒のクリップではセリフを短く保つ
- リミックスでは不変条件を明示的に述べる(同じショット、同じカメラムーブ)
- 連続性を保つために、単一変更のフォローアップで反復する
アセットタイプ別ガイダンス
特定の成果物のリクエストがある場合は、これらのモジュールを使用します。対象に特化したテンプレートとデフォルトを提供します。
- 映画的なショット:
references/cinematic-shots.md - ソーシャル広告:
references/social-ads.md
CLI + 環境に関する注意
- CLIコマンドと例:
references/cli.md - APIパラメータクイックリファレンス:
references/video-api.md - プロンプトガイダンス:
references/prompting.md - サンプルプロンプト:
references/sample-prompts.md - トラブルシューティング:
references/troubleshooting.md - ネットワーク/サンドボックスのヒント:
references/codex-network.md
リファレンスマップ
references/cli.md:scripts/sora.pyを使用したcreate/poll/remix/download/batchの実行方法references/video-api.md: APIレベルの設定項目(モデル、サイズ、長さ、バリエーション、ステータス)references/prompting.md: プロンプト構造と反復ガイダンスreferences/sample-prompts.md: コピー&ペーストで使えるプロンプトレシピ(例のみ、追加理論なし)references/cinematic-shots.md: 映画的なショットのテンプレートreferences/social-ads.md: 短いソーシャル広告ビートのテンプレートreferences/troubleshooting.md: 一般的なエラーと修正方法references/codex-network.md: ネットワーク/承認に関するトラブルシューティング