图像类型
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'