HiAPI 食品・飲料コマーシャル動画 は何をしますか？
魅力的で美味しそうな、短いコマーシャルショットを1つ作成します。製品の真実味を保ち、物理的な妥当性を確保し、有料タスクの境界を明確にしてください。
リクエストのルーティング
1つのレシピと1つのメディアルートを選択します：
| レシピ | 最適な用途 |
|---|---|
product-hero | パッケージ食品、缶、ボトル、瓶、Eコマースのヒーローショット |
coffee-pour | コーヒー、紅茶、ミルク、クレマ、スチーム、カフェドリンク |
beverage-splash | 炭酸飲料、ジュース、スパークリングウォーター、エナジードリンクのショット |
food-macro | テクスチャー、焼き加減、ソースかけ、チーズの伸び、盛り付けの詳細 |
restaurant-atmosphere | ダイニングルームやカウンターサービスで提供される料理の様子 |
| メディア入力 | ルート | モデル |
|---|---|---|
| 画像なし | テキスト→動画 | kling-3.0-omni/text-to-video |
厳密に1つの --hero-image-* | ヒーロー画像→動画 | kling-3.0-omni/image-to-video |
1～9個の --reference-image-* | 複数参照生成 | seedance-2.0-fast |
ヒーロー画像と参照画像を混在させないでください。パッケージの形状、ラベルの位置、ブランドカラー、または特定の料理を認識可能に保つ必要がある場合は、ヒーロー画像または参照画像を優先してください。
人が話したり、味見したり、プレゼンしたりする場面、または既存の動画からのアクションやカメラガイダンスは処理しないでください。そのようなリクエストは、専用のスポークスパーソンまたは参照モーションスキルにルーティングしてください。利用可能なスキルがない場合は、このスキルはそのワークフローをサポートしていないことを説明してください。
ブリーフの作成
製品または料理、1つの主要なアクション、1つのカメラワーク、出力比率、長さ、および回避すべき主張を確認します。ユーザーが長さを省略した場合は、まずリクエストをルーティングし、短く調整されたメニューを提供し、--dry-run の前に選択または4秒の低コストデフォルトの明示的な承諾を待ちます。
選択されたモデルの範囲内で、すべての整数秒を受け入れます：Kling テキスト→動画とヒーロー画像→動画は3～15秒をサポートし、Seedance Fast 参照画像生成は4～15秒をサポートします。これらの計画バンドをハードなプリセットにせずに使用します：
| 長さ | 最適な用途 |
|---|---|
| 3～4秒 | 即時のフック、飛沫、またはパッケージの披露；3秒はKlingのみ |
| 5～6秒 | 短い製品保持を伴う高速ソーシャルまたはEコマースのヒーローショット |
| 7～9秒 | 読み取り可能な落ち着き時間を伴う完全な注ぎ、ソースかけ、テクスチャー、または披露 |
| 10～12秒 | プレミアムなスローディスカバリーまたは控えめなペースのレストラン雰囲気 |
| 13～15秒 | 動作が意味を保つ場合のみの意図的な長回し；最もコストが高く、継続性リスクが高い |
長い長さは、追加のカットや無関係なビートを許可しません：1つのアクション、1つのカメラワーク、1つの連続したショットを維持します。レシピは簡潔なデフォルトを提供します。ブリーフが必要とする場合は、--action、--setting、--lighting、--texture、--camera、または --sound でオーバーライドします。
レシピのデフォルトと食品固有の真実味の制約については、references/prompting.md を参照してください。
支出と機密情報の保護
まずオフラインで、編集された完全なペイロードをプレビューします：
node scripts/hiapi-food-commercial-video.mjs `
--recipe coffee-pour `
--prompt "プレミアムカフェ向けのダークローストコーヒーの陶器のカップ" `
--duration 4 `
--ratio 9:16 `
--preview
ユーザーにHiAPIに問い合わせるが有料タスクは作成しないことを伝えた後にのみ、実際のチェックを実行します：
node scripts/hiapi-food-commercial-video.mjs --check --env-file "D:\path\to\.env.local"
次に、公開ライブカタログから意図したリクエストの価格を算出します：
node scripts/hiapi-food-commercial-video.mjs `
--recipe product-hero `
--hero-image-file "D:\media\product.jpg" `
--prompt "清潔な冷たいカウンターに置かれた、提供されたスパークリングウォーターの缶" `
--duration 4 `
--dry-run
--spend --approved-request-hash HASH は、ユーザーが一致する --dry-run で出力されたライブ見積もり、予算、およびハッシュを明示的に承認した後にのみ使用します。デフォルトのクライアント見積もり制限は $0.50 です。承認された予算内でのみ --max-cost-usd をオーバーライドします。これはサーバーで強制される最終請求上限ではありません。アカウントグループの比率が適用される可能性があるためです。呼び出しごとに最大1つの有料タスクを作成します。
HIAPI_API_KEY をプロセス環境または --env-file から読み取ります。決して出力、永続化、または成果物に含めないでください。固定のAPIホストと一時的な出力ストレージを維持します。
安全に再開する
CLIは冪等性キーを承認されたリクエストハッシュにバインドし、送信前にそれを出力し、作成直後にタスクIDを出力します。タスクIDが返される前に送信が中断された場合は、その正確な --idempotency-key を再利用します。重複キーの応答にすでにタスクIDが含まれている場合は、現在のブリーフを添付せず、既存のタスクを個別に再開します。タスクIDが存在した後は、次のコマンドのみで再開します：
node scripts/hiapi-food-commercial-video.mjs --task-id TASK_ID --env-file "D:\path\to\.env.local"
ポーリングまたは品質レビューの失敗後に、自動的に代替タスクを送信しないでください。
パッケージのレビュー
final.mp4、brief.md、編集済み prompt.json、manifest.json、および食品固有の qc.json を保存します。generated_unreviewed を最終的な自動ステータスとして扱います。公開または製品、原材料、アレルゲン、アルコール、栄養、認証、健康に関する主張を行う前に、人間によるレビューを必須とします。
成果物のセマンティクスとQCチェックリストについては references/output.md を参照してください。ルート、価格ロジック、リトライ、タスク処理を変更する場合は references/api.md を参照してください。