获取 API 密钥

图片

响应中的图片路径都从 https://img.amodb.dev/t/p/{size}/{file} 加载，尺寸与 TMDB 一致，从 w92 到 original。图片无需密钥，不计入速率，边缘缓存 30 天。

更新于 以 Markdown 查看

URL 模式

Text 
https://img.amodb.dev/t/p/{size}/{file}

{file} 是响应字段中的路径，例如 poster_path、backdrop_path、profile_path、still_path 或 logo_path。它本身已经以 / 开头。

Text 
https://img.amodb.dev/t/p/w500/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg

尺寸

尺寸宽度或高度适合用于
w92宽 92 px搜索建议
w154宽 154 px密集列表
w185宽 185 px桌面端网格、人物照片
w300宽 300 px背景图缩略图、OMDb 的 Poster
w342宽 342 px高密度屏幕手机上的网格
w500宽 500 px详情页
w780宽 780 px大海报、中等背景图
w1280宽 1280 px全宽背景图
h632高 632 px全高人物照片
original源文件尺寸下载和印刷

海报比例为 2:3。请在 <img> 上设置 width 和 height，避免页面在加载时发生位移。

配置接口返回的基础 URL

GET /3/configuration 返回与 TMDB 相同的结构。根据它来构造图片 URL 的客户端，无需任何改动即可使用。

边缘会把 /3/configuration 保留 24 小时，所以每天读取一次就够了。

JSON 
{
  "images": {
    "base_url": "http://img.amodb.dev/t/p/",
    "secure_base_url": "https://img.amodb.dev/t/p/",
    "poster_sizes": ["w92", "w154", "w185", "w342", "w500", "w780", "original"]
  }
}

响应式图片

JavaScript 
const base = "https://img.amodb.dev/t/p";
const srcset = ["w185", "w342", "w500"]
  .map((size) => `${base}/${size}${movie.poster_path} ${size.slice(1)}w`)
  .join(", ");

const html = `<img src="${base}/w342${movie.poster_path}" srcset="${srcset}"
  sizes="(min-width: 64rem) 185px, 33vw" width="342" height="513"
  alt="${movie.title} poster" loading="lazy">`;

缓存

图片在边缘缓存中保留 30 天。请把文件路径与你的记录一起存储，渲染时再拼出 URL，这样以后切换尺寸就不需要新的 API 调用。