图像类型

poster_path:poster_path 将首先查询您在请求中指定的语言,如果存在,则回退到媒体“原始语言”中评分最高的图像。如果该图像不存在,则直接回退到评分最高的图像。需要注意的是,尽管我们的语言查询参数支持区域查找,但目前这些区域变体并不适用于图像。此功能将在稍后添加。

backdrop_path:由于 99% 的背景图不包含特定语言,背景图的默认查找方式是仅查询评分最高的背景图,不指定语言。如果不存在,则返回整体评分最高的图像。

still_path:与背景图类似,电视剧集的剧照本身也不包含语言信息。我们查询评分最高的剧照。

默认语言

注意

请记住,当您查询任一 /images 方法时,您的 language 参数将对图像进行过滤。由于您通常希望查询多种语言的图像,因此应使用 include_image_language 查询参数。您可以将其视为提供后备方案的一种手段。

请查看下方示例,其中展示了如何请求标记为英语以及未标记任何语言的图像。

curl --request GET \
     --url 'https://api.themoviedb.org/3/movie/550/images?language=en-US&include_image_language=en,null' \
     --header 'Authorization: Bearer ACCESS_TOKEN' \
     --header 'accept: application/json'

请注意 include_image_language 参数。此查询 (en-US,null) 旨在查找所有匹配英语(美国)且尚未设置语言标签(null)的图像。

更进一步,您可以使用 append_to_response 在单个请求中查询此图像方法:

curl --request GET \
     --url 'https://api.themoviedb.org/3/movie/550?append_to_response=images&language=en-US&include_image_language=en-US,null' \
     --header 'Authorization: Bearer ACCESS_TOKEN' \
     --header 'accept: application/json'