HiAPI ファッションルックブックビデオ
1つの短いファッションショットを作成します。人物は承認済み、衣服は認識可能、参照の役割は明示的、有料生成は個別に承認すること。
リクエストのルーティング
以下のレシピから選択します：
| レシピ | 最適な用途 |
|---|---|
runway-walk | 全身ウォークが1つのコントロールされたポーズで終わるもの |
outfit-transition | 開始から目標アウトフィットへの1回の変形 |
lookbook-pose | 1つの完全なルックを見せるスローターンまたはポーズ |
person-showcase | 抑制された動きの非発声ファッションポートレート |
提供されたアセットからメディアルートを選択します：
| メディア入力 | ルート | モデル |
|---|---|---|
| 画像なし | テキスト動画変換 | kling-3.0-omni/text-to-video |
| ちょうど1枚の人物画像または全身ルック画像、他に画像なし | 画像動画変換 | kling-3.0-omni/image-to-video |
| 衣服またはスタイル参照、最大9枚の画像 | マルチ参照生成 | seedance-2.0-fast |
使用する人物画像は最大1枚、1つのターゲットルックに対する衣服画像は最大6枚、スタイル画像は最大2枚です。合計上限は9枚です。参照駆動の outfit-transition には1枚の人物画像と少なくとも1枚の衣服画像が必要です。テキストのみの outfit-transition は架空のものであり、特定の衣服や同一性を保証できません。
発声プレゼンターは $hiapi-product-spokesperson-video に委任します。動画からのアクションやカメラガイダンスは $hiapi-reference-motion-transfer に委任します。マルチショット編集、キャプション、音楽、ロゴ、CTA合成は動画編集ワークフローに委任します。
権利と範囲の確認
画像を使用する前に、ユーザーが画像を所有しているか、使用が許可されていることを確認します。すべてのメディアリクエストで --asset-rights-confirmed を必須とし、人物画像が提供される場合はさらに --person-consent-confirmed を必須とします。画像自体から同意、所有権、またはクリーンな商用ライセンスを推測しないでください。
生成された出力はクリエイティブなファッションビジュアライゼーションとして説明します。正確なフィット感、サイズ、テーラリング、生地の性能、または購入者に衣服がどのように見えるかの証拠として説明しないでください。体型、年齢、民族、医療、または魅力に関する主張を行わないでください。
レシピ、1つの主要なアクション、1つのカメラ移動、長さ、出力比、ターゲット衣服の詳細、および音声が必要かどうかを確認します。生成音声はデフォルトでオフです。レシピのデフォルト、参照の役割、タイミング、ファッションの真実の制約については references/prompting.md を参照してください。
支出前のプレビュー
完全な編集済みペイロードをオフラインでプレビューします：
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe lookbook-pose `
--prompt "立っている成人モデルが1つの構造化された黒のイブニングルックを提示" `
--duration 5 `
--ratio 9:16 `
--preview
承認された人物とターゲット衣服の場合：
node scripts/hiapi-fashion-lookbook-video.mjs `
--recipe outfit-transition `
--person-image-file "D:\media\person.jpg" `
--garment-image-file "D:\media\dress-front.jpg" `
--garment-image-file "D:\media\dress-back.jpg" `
--person-consent-confirmed `
--asset-rights-confirmed `
--prompt "提供されたイブニングドレスへの1回のクリーンな変更" `
--garment-details "スクエアネックライン、フィットしたウエスト、アンクル丈、シルバーボタンを保持" `
--duration 5 `
--ratio 9:16 `
--preview
ライブチェックは、ユーザーにHiAPIに連絡するが有料タスクは作成しないことを伝えた後にのみ実行します：
node scripts/hiapi-fashion-lookbook-video.mjs --check --env-file "D:\path\to\.env.local"
次に、--dry-run で正確なリクエストの価格を設定します。これは公開ライブカタログを読み取り、タスクは作成しません。デフォルトのローカル見積もり制限は $1.00 です。承認された予算内でのみ --max-cost-usd を上書きします。公開価格はサーバー側の最終請求上限ではありません。アカウントグループ比率が適用される場合があります。
--spend --approved-request-hash HASH は、ユーザーが一致するライブ見積もり、予算、およびリクエストハッシュを明示的に承認した後にのみ使用します。1回の呼び出しで最大1つの有料タスクを作成します。APIキーは HIAPI_API_KEY または --env-file から読み取ります。決して印刷または永続化しないでください。
安全に再開する
CLIはその冪等性キーを承認されたリクエストハッシュにバインドし、作成直後にタスクIDを出力します。正確に印刷された --idempotency-key を再利用するのは、タスクIDが返される前に送信が中断された場合のみです。タスクIDが存在する場合は、再送信せずに再開します：
node scripts/hiapi-fashion-lookbook-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 を最終的な自動ステータスとして扱います。公開、eコマース使用、有料広告、または衣服、同一性、フィット感、サイズ、素材、原産地、認証、パフォーマンスに関する主張を行う前に、人間によるレビューを必須とします。
アーティファクトのセマンティクスとファッションQCチェックリストについては references/output.md を参照してください。モデル、ルート、価格設定、リトライ、タスク処理を変更する前に references/api.md を参照してください。