Codexでローカル素材をアップロードする

使いたいファイルの場所をCodexに伝えます。HolyCrabはネット送信前にローカルで確認し、完全な一覧を表示します。

Codexにアップロードを頼む

1. ファイル場所を伝える

以下は絶対パスの例です。自分のファイルの実際のパスに置き換えてください。Demo/demoはユーザー名の例です。

Windows: C:\Users\Demo\Pictures\front.jpg と C:\Users\Demo\Videos\motion.mp4。

macOS: /Users/demo/Pictures/front.jpg と /Users/demo/Movies/motion.mp4。

Linux: /home/demo/Pictures/front.jpg と /home/demo/Videos/motion.mp4。

Codexに「HolyCrabで次の2つの参考素材のアップロードを準備して:[画像のパス] と [動画のパス]。まず一覧を表示し、私が確認するまでアップロードしないで」と伝えます。

2. プレビューを確認

対象、絶対パス、名前、形式、サイズ、既知の長さを各ファイルで確認します。フォルダーではなく個々のファイルを選び、非対応と表示されたファイルは置き換えます。

3. 1回だけ承認

全て正しければバッチ全体を承認します。違いがあれば中止し、新しい一覧を作ります。

4. 確認後にファイルを変えない

実行直前に再確認されます。プレビュー後に置き換え・編集したファイルは送信されません。

5. 処理を待つ

返されたAsset IDを保存し、対象モデルに合わせてCodexに確認してもらいます。そのモデルで処理待ちが必要な場合は同じIDを照会し、重複アップロードはしません。

途中で止まった場合

結果意味次の操作
uploadedAsset IDを取得済み。対象モデルに合わせて同じIDを確認する。
failed / unknown失敗または結果不明。IDと表示を保存し、再送せず先に照会する。
not attempted後続ファイルは開始していない。最初の問題を直し、必要な分だけ新しい計画を作る。

使用するモデルごとに素材を確認

  • Asset IDの取得はアップロード登録の完了を示します。すべてのモデルで使用できるとは限らないため、使用予定のモデルをCodexに伝えます。
  • Seedanceは審査の承認が必要です。審査中は同じAsset IDを照会し、失敗したら理由に従います。KlingやMiniMaxはこの審査の完了を待たず、審査中や失敗の表示でも対象モデルで生成見積もりを依頼します。
  • 削除中の素材はどのモデルでも使えません。別の既存素材を選んでください。
  • ファイルサイズ、長さ、参照数の条件はモデルごとに異なります。見積もりでファイル情報の処理中と表示された場合は同じAsset IDを待ちます。明確な失敗なら理由に従い、素材を変更します。

ターミナルから操作したい

任意のアップロードコマンドを表示

対話コマンドがファイル一覧を表示し、承認を求めます。ASSET_IDを実際のIDに置き換え、使用するモデル名を指定してください。以下はKling 4.0の例です。

macOS / Linux

holycrab assets upload /absolute/path/front.jpg /absolute/path/motion.mp4

Windows PowerShell

holycrab assets upload "C:\Users\Demo\Pictures\front.jpg" "C:\Users\Demo\Videos\motion.mp4"
holycrab assets get ASSET_ID --model kling-4.0
holycrab assets wait ASSET_ID --model kling-4.0 --timeout 600

うまくいかない場合

  • ローカル確認の失敗なら対象ファイルを直します。そのバッチは何も送信されていません。
  • 拒否された場合は対象モデルと理由を確認してから、素材の変更や再アップロードを判断します。
  • 結果不明ならAsset IDを保存し、先に照会します。