서문
Brightcove 이미지 API는 간단한 GET 요청을 사용하여 이미지 크기를 조정, 자르기 및/또는 회전하는 빠르고 쉬운 방법을 제공합니다.
요청 URL
이미지 API에 대한 요청 URL은 다음과 같습니다.
https://images.brightcovecdn.com/image/v1/{account_id}/{image-token}/url/{image_url}필수 경로 매개변수는 다음과 같습니다.
account_id: 귀하의 비디오 클라우드 계정 IDimage-token: 계정의 인증 토큰 (브라이트코브 지원에서 생성해야 함)image_url: 이미지를 찾을 수 있는 공개 URL
URL 매개 변수
이미지의 변환된 버전을 얻으려면 요청에서 아래에 설명된 URL 매개변수 중 하나 이상을 사용하십시오. 3개 매개변수의 모든 조합을 사용할 수 있습니다.
| 매개 변수 | 설명 |
|---|---|
resize |
이 값을 “너비x높이”와 동일하게 설정하여 이미지 크기를 조정하십시오 - 예: resize=160x90 )
|
fallback |
true인 경우, 요청된 이미지를 반환할 수 없는 경우 API는 검은색 이미지를 반환합니다. |
fillArea |
크기 조정 매개변수로 지정된 영역을 완전히 채우는 이미지의 종횡비를 유지합니다. 기본 동작은 동일한 영역의 한 면만 채웁니다. |
crop |
너비와 높이를 “widthxheight”로 설정하여 자릅니다. 예: crop=160x90 - 원점이 이미지의 중심입니다. |
rotate |
이미지를 지정된 각도만큼 시계 방향으로 회전합니다. 예: rotate=90 |
nocache |
API true응답에 값이 포함된Cache-Control헤더가 포함되는지 여부public, max-age=0 .
|
watermark |
재생 버튼 아이콘이 이미지에 추가되는 경우true |
모범 사례
변환된 이미지가 웹 페이지 또는 온라인 앱에 표시되는 경우 API를 사용하여 이미지를 검색하고 서버에 저장하십시오. API에 대한 속도 제한으로 인해 트래픽이 많은 페이지 또는 앱에서 일부 요청이 실패하고 API 요청이 항상 수행되도록 하여 페이지/앱의 성능이 저하되므로 런타임에 검색 하지 마십시오. 사용자가 로드했습니다.
예
다음은 아래 예제의 원본 이미지입니다.
크기 조정 ( resize매개변수 사용)
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?resize=221x300
자른
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?crop=580x670
회전
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?rotate=-90
크기 조정 및 채우기 영역
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?resize=200x300&fillArea=true
크기 조정 및 회전
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?resize=221x300&rotate=-90
자르기 및 회전
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?crop=570x660&rotate=-90
크기 조정, 자르기 및 회전
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?resize=221x300&crop=570x660&rotate=-90
워터마크
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?watermark=true
캐시 없음
요청
https://images.brightcovecdn.com/image/v1/1752604059001/XXXXXXXXXX/url/https%3A%2F%2Fapis.support.brightcove.com%2Fassets%2Fimages%2Fimage-api%2Fleaf.jpg?resize=221x300&nocache=true다음은 응답 헤더입니다 ( Insomnia에서반환됨).
