이 페이지에서는 Tenor API에서 사용하는 다양한 JSON 응답 및 오류 객체에 대한 정보를 제공합니다.
응답 객체
다음 표에서는 응답 객체의 속성에 대한 세부정보를 제공합니다.
속성 | |
---|---|
created |
이 게시물이 생성된 시점을 나타내는 Unix 타임스탬프입니다. |
hasaudio |
이 게시물에 오디오가 포함된 경우 |
id |
Tenor 결과 식별자 |
media_formats |
|
tags |
게시물의 태그 배열 |
title |
게시물 제목 |
content_description |
콘텐츠에 대한 텍스트 설명입니다. 사용자 접근성 기능에는 |
itemurl |
tenor.com에서 게시물을 볼 수 있는 전체 URL입니다. |
hascaption |
이 게시물에 자막이 포함되어 있으면 |
flags |
쉼표로 구분된 목록. 콘텐츠가 스티커 이미지인지 정적 이미지인지 또는 오디오와 같거나 그 조합인지를 나타냅니다. |
bg_color |
콘텐츠의 가장 일반적인 배경 픽셀 색상 |
url |
tenor.com에서 게시물을 보는 약식 URL. |
카테고리 객체
다음 표에는 카테고리 객체의 속성에 대한 세부정보가 나와 있습니다.
속성 | |
---|---|
searchterm |
카테고리에 해당하는 검색어입니다. 검색어는 해당 요청의 |
path |
사용자가 카테고리를 선택하는 경우 요청할 검색 URL |
image |
카테고리의 예시 GIF에 대한 미디어 소스 URL |
name |
이미지 위에 오버레이할 카테고리 이름입니다. 이름은 해당하는 요청의 |
미디어 객체
다음 표에는 미디어 객체의 속성에 대한 세부정보가 나와 있습니다.
속성 | |
---|---|
url |
미디어 소스 URL |
dims |
미디어의 너비 및 높이(픽셀)입니다. |
duration |
콘텐츠의 한 루프에 대한 시간(초)을 나타냅니다. 콘텐츠가 정적인 경우 기간은 |
size |
파일의 크기(바이트) |
콘텐츠 형식
Tenor의 API는 다양한 크기로 다음의 다섯 가지 기본 형식을 제공합니다.
- GIF
- MP4
- WebM
- 투명한 WebP
- 투명 GIF
MP4 및 WebM 형식은 클립을 한 번만 재생합니다. 단, 클립을 몇 번 재생하는 loopedmp4
는 예외입니다. GIF 형식은 연속 루프에서 클립을 재생합니다. 투명한 형식은 스티커 콘텐츠용이며 GIF 검색결과에서 사용할 수 없습니다.
형식 유형
다음 표에는 Tenor에 사용할 수 있는 미디어 형식 유형이 자세히 나와 있습니다.
형식 유형 | |
---|---|
preview |
이 형식은 GIF 및 스티커에 지원됩니다. |
gif |
이 형식은 GIF 및 스티커에 지원됩니다. |
mediumgif |
이 형식은 GIF 및 스티커에 지원됩니다. |
tinygif |
이 형식은 GIF 및 스티커에 지원됩니다. |
nanogif |
이 형식은 GIF 및 스티커에 지원됩니다. |
mp4 |
이 형식은 GIF 및 스티커에 지원됩니다. |
loopedmp4 |
이 형식은 GIF 및 스티커에 지원됩니다. |
tinymp4 |
이 형식은 GIF 및 스티커에 지원됩니다. |
nanomp4 |
이 형식은 GIF 및 스티커에 지원됩니다. |
webm |
이 형식은 GIF 및 스티커에 지원됩니다. |
tinywebm |
이 형식은 GIF 및 스티커에 지원됩니다. |
nanowebm |
이 형식은 GIF 및 스티커에 지원됩니다. |
webp_transparent |
이 형식은 스티커에서 지원됩니다. |
tinywebp_transparent |
이 형식은 스티커에서 지원됩니다. |
nanowebp_transparent |
이 형식은 스티커에서 지원됩니다. |
gif_transparent |
이 형식은 스티커에서 지원됩니다. |
tinygif_transparent |
이 형식은 스티커에서 지원됩니다. |
nanogif_transparent |
이 형식은 스티커에서 지원됩니다. |
권장사항
- 모바일의 경우 미리보기에는 nano 또는 아주 작은 파일을 사용하고 공유에는 아주 작은 파일을 사용합니다.
media_filter
매개변수를 사용하려는 형식으로 설정합니다. 이렇게 하면 API 응답 크기가 70% 감소할 수 있습니다.
형식 크기
각 콘텐츠 형식의 파일 크기는 선택한 특정 GIF의 크기와 길이에 따라 다릅니다. 따라서 다음 표에 제공된 평균과 중앙값은 하드 값 대신 일반적인 가이드라인으로 간주하시기 바랍니다.
파일 형식 | 평균 파일 크기 (KB) | 파일 크기 중앙값 (KB) |
---|---|---|
gif |
3,356회 | 956 |
mediumgif |
2,548명 | 574 |
tinygif |
521 | 101 |
nanogif |
175 | 56 |
mp4 |
207 | 91 |
loopedmp4 |
515 | 228 |
tinymp4 |
84 | 81 |
nanomp4 |
37 | 28개 |
webm |
76 | 61 |
tinywebm |
57 | 45 |
nanowebm |
35 | 25 |
webp_transparent |
530 | 95 |
tinywebp_transparent |
249 | 60 |
nanowebp_transparent |
107 | 25 |
gif_transparent |
643 | 35 |
tinygif_transparent |
349 | 20태국 바트 |
nanogif_transparent |
116 | 10 |
응답 코드
다음 표에서는 성공적인 요청을 나타내는 데 사용되는 HTTP 상태 응답 코드를 보여줍니다.
HTTP 상태 코드 | |
---|---|
200 또는 202 |
확인 또는 수락 |
오류
Tenor의 API는 HTTP 응답 코드 4xx
또는 5xx
와 함께 표준 Google API 오류 형식으로 오류를 반환합니다. 자세한 내용은 오류를 참조하세요.