メインコンテンツまでスキップ

画像配信

すべてのコンテンツサムネイルとソースアイコンは、自動画像最適化機能を備えたグローバル 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 1681.91:1（OGP 標準）
プッシュ候補1024 x 5122: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 ではなくソース側のドメインになることがありますが、動作に影響はありません。このフォールバックは自動的に適用されるため、クライアント側での対応は不要です。