画像配信

すべてのコンテンツサムネイルとソースアイコンは、自動画像最適化機能を備えたグローバル CDN を通じて配信されます。

仕組み

API レスポンスの thumbnail.url は、最適化され CDN にキャッシュされた画像を指します。追加の処理は不要で、そのまま直接使用できます。

{
  "thumbnail": {
    "url": "https://img.feed.storyhub.studio/...",
    "width": 320,
    "height": 168
  }
}

機能

機能	説明
フォーマット変換	ブラウザーの Accept ヘッダーに基づく WebP/AVIF の自動変換
スマートクロッピング	サムネイル用の顔検出対応クロッピング
CDN キャッシュ	グローバルエッジ配信による30日間のキャッシュ
署名付き URL	不正利用防止のため、すべての画像 URL に署名を付与

デフォルトサイズ

コンテキスト	サイズ	アスペクト比
フィードサムネイル	320 x 168	1.91:1（OGP 標準）
プッシュ候補	1024 x 512	2:1（モバイル最適化）

サムネイルのサイズはシナリオごとにカスタマイズできます。カスタム設定については、担当のアカウントマネージャーにお問い合わせください。

実装のヒント

• thumbnail.url を <img> タグで直接使用してください。CDN がフォーマットネゴシエーションを処理します。
• thumbnail.width と thumbnail.height フィールドは、レイアウトのヒント（例: aspect-ratio CSS）として提供されます。
• ソース画像が利用できない場合、API はプレースホルダー URL を返します。常に有効な thumbnail オブジェクトを受け取ることができます。

ソース側 CDN からの直接配信

コンテンツソース（メディア）側が独自の CDN を用意しており、クラウドサービスからのアクセスを制限（WAF 等）している場合があります。この場合、画像最適化サーバー経由でのアクセスがブロックされるため、元画像の URL がそのまま thumbnail.url として配信されます。thumbnail.url のドメインが img.feed.storyhub.studio ではなくソース側のドメインになることがありますが、動作に影響はありません。このフォールバックは自動的に適用されるため、クライアント側での対応は不要です。