transform-describe-image-with-transloadit

入力

• ローカルの入力画像の絶対パス
• 任意の .json 出力パス。デフォルトは同じパスに .json を付けたものです

準備

次の順に認証情報を解決します。

• シェル環境変数
• 現在の作業ディレクトリにある .env のみ
• ~/.transloadit/credentials

.env が親ディレクトリにある場合は、まずシェルに変数をエクスポートしてください。

実行

公式の Transloadit Node CLI を直接使用します。

ラベル／オブジェクト形式の説明：

npx -y @transloadit/node image describe \
  --input ./input.jpg \
  --fields labels \
  --output ./labels.json

WordPress 対応フィールド：

npx -y @transloadit/node image describe \
  --input ./input.jpg \
  --for wordpress \
  --output ./fields.json

カスタムフィールドの選択：

npx -y @transloadit/node image describe \
  --input ./input.jpg \
  --fields altText,title,caption,description \
  --output ./fields.json

--output を省略すると、CLI は入力画像と同じ場所に、同じベース名の JSON ファイルを書き込みます。コマンドの実行後、想定した出力パスに JSON ファイルが存在することを確認してください。

出力形式

--fields labels はラベルの JSON 配列を返します。

--for wordpress と指定した --fields ... は、要求された文字列フィールドを含む JSON オブジェクトを返します。例：

{
  "altText": "...",
  "title": "...",
  "caption": "...",
  "description": "..."
}

メモ

• 公開可能な CMS フィールドが必要な場合は、--for wordpress を優先してください。
• 作成されたコピーではなく、認識結果のタグが必要な場合は、--fields labels を優先してください。
• --model が関係するのは作成されたフィールドのみで、labels には関係しません。
• 再利用可能なユーザーレベルの設定には、デフォルトのフォールバックとして ~/.transloadit/credentials を優先してください。
• 現在のディレクトリにある .env は引き続き優先されるため、アカウント選択を確実にしたい場合は使用を避けてください。
• 認証情報がリポジトリのルートにある .env にしかない場合は、そのディレクトリからコマンドを実行するか、先に変数をエクスポートしてください。

失敗した場合のデバッグ

npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j