Lorem Picsum
所有文章
指南

LoremFlickr 連不上?替代服務與圖片網址遷移方式

LoremFlickr 圖片載入失敗?先確認 Flickr API 的狀態,再比較 Lorem Picsum、自架 LoremFlickr 與 Unsplash API,試用可直接複製的圖片網址,為網頁測試準備備援。

原本出現在網頁版型、Storybook 元件或測試頁面的佔位圖片,突然變成破圖時,可以先單獨開啟圖片網址。LoremFlickr 維護者在 更新紀錄 中表示,Flickr 於 2026 年 10 月 21 日再次封鎖該站對 API 的存取。LoremFlickr 要從 Flickr 取回符合關鍵字的照片,因此上游存取一旦中斷,即使網頁本身沒改,圖片仍可能失效。

怎麼確認是 LoremFlickr 的問題?

先測試一個不帶關鍵字的網址,再測試 dog 等常見主題。在開發者工具的「網路」頁籤查看重新導向後的狀態碼及 Content-Type。最後回傳 200 且能解碼成圖片,代表這條網址可用。一張題材不符的照片可能是沒找到標籤時的備用結果,不能當作站點故障。

如果網址在新分頁能開、掛進網頁就失敗,檢查 CSP 的 img-src、HTTPS 網頁是否混用 HTTP 資源,以及瀏覽器擴充功能有沒有擋住該網址。若只有 CI 環境拿不到照片,再從 runner 直接請求,確認代理伺服器和出站規則。若多個網路同時有問題,查維護者紀錄比一直清快取更有用。

LoremFlickr 替代方案怎麼選?

  • Lorem Picsum(picsum.org):接收尺寸網址,能依主題搜尋 CC0 照片。已有 dog、coffee 等標籤的版型,可先找一張構圖適合的照片,再把其中一個網址換掉測試。
  • 自架 LoremFlickr v3:想保留原有的關鍵字行為,可以參考維護者提供的第三版。你需要自己的 Flickr API 金鑰、主機及請求配額管理,仍會受 Flickr 上游規則影響。
  • Unsplash API:如果要讓編輯先搜尋再挑選主視覺,正式 API 提供關鍵字搜尋。整合時要處理存取金鑰、速率限制、署名及圖片網址的使用規範。

將關鍵字網址遷移到 Lorem Picsum

第一行是舊的路徑式關鍵字,第二行把主題移到 tag 查詢參數,第三行則為同一格版型設定固定的 seed。

https://loremflickr.com/320/240/dog
https://picsum.org/800/600?tag=dog
https://picsum.org/seed/dog/800/600.webp

舊網址的 lock 值和新服務的 seed 沒有對應關係。像 lock=7 這樣的值可改成 seed,但請重新檢查照片題材和裁切。舊的 /g/ 灰階路徑可以改成查詢參數 grayscale=1。800 × 600 和 320 × 240 的比例相同。如果版面真的需要 320 × 240,直接把新網址的寬高換回去,並同步更新 HTML 屬性。

關鍵字一樣,照片一定一樣嗎?

tag 是從符合標籤的候選照片中抽選,seed 則讓同一套目錄內的選擇可以重現。兩個圖庫的標籤分類和照片都不同。換完網址後逐張檢查,尤其是帶有寵物、地點或商品語意的範例。需要長期讓測試畫面完全一致,請固定照片 ID 或使用本機檔案。

設定尺寸、格式與本機備援

在 Lorem Picsum 圖片產生器 先選版面比例,輸入寬和高,再複製產生的圖片網址。公開圖片網址支援 JPEG、WebP、每邊最高 2,000 像素的自訂尺寸,以及灰階和模糊,不需要登入、API 金鑰或點數。下列範例會要求 1,040 × 560 的 WebP,轉成灰階並套用強度為 4 的模糊。

https://picsum.org/1040/560.webp?grayscale=1&blur=4

把圖片放回頁面時,設定與檔案相符的 width 和 height,並用 CSS 決定顯示大小。列出行動版和桌面版兩種顯示方式,檢查在窄螢幕上是否裁掉人物或文字。需要自動載入不同大小時,準備對應的圖片網址供 srcset 使用。替代文字要描述照片提供的資訊。如果只是裝飾,可用空的 alt,讓輔助工具略過。

遠端載不出來時,備援要怎麼測?

把同一個長寬比的備援照片和專案一起打包。圖片載入事件回傳錯誤時,換成本機路徑,並確保錯誤處理最多執行一次,避免備援本身失效時一直重試。開發時可在瀏覽器中封鎖外部網域,確認不會看到破圖、版面不跳動,並檢查替代文字。CI 做螢幕截圖時可以直接從本機讀取測試圖檔,服務是否在線就不會左右測試結果。

授權和輸出規格有什麼要注意?

Lorem Picsum 圖庫的照片是 CC0,日後若替換成其他來源,須重新檢查授權與 API 條款。把重要的測試照片、來源與許可一起留在專案中,團隊交接時才能重建畫面。要覆核參數、分類與公開限制,可查閱 圖片網址參考。

如果你是在處理另一個同名服務的 5xx,請參考 Picsum Photos 故障與備援指南。