응답 객체 및 오류

이 페이지에서는 Tenor API에서 사용되는 다양한 JSON 응답 및 오류 객체에 관한 정보를 제공합니다.

응답 객체

다음 표에서는 응답 객체의 속성을 자세히 설명합니다.

속성
created	float 이 게시물이 생성된 시간을 나타내는 Unix 타임스탬프입니다.
hasaudio	boolean 이 게시물에 오디오가 포함된 경우 true를 반환합니다. 참고: 오디오는 동영상 형식만 지원합니다. GIF 이미지 파일 형식에는 오디오 정보가 포함될 수 없습니다.
id	string 테너 결과 식별자
media_formats	{ CONTENT_FORMAT : MEDIA_OBJECT } 콘텐츠 형식이 키이고 미디어 객체가 값인 딕셔너리입니다.
tags	string[] 게시물의 태그 배열
title	string 게시물 제목
content_description	string 콘텐츠의 텍스트 설명입니다. 사용자 접근성 기능에는 content_description을 사용하는 것이 좋습니다.
itemurl	string tenor.com에서 게시물을 볼 수 있는 전체 URL입니다.
hascaption	boolean 이 게시물에 자막이 포함된 경우 true을 반환합니다.
flags	string 콘텐츠가 스티커인지, 정지 이미지인지, 오디오가 있는지 또는 이들의 조합인지 나타내는 쉼표로 구분된 목록입니다. sticker 및 static이 없으면 콘텐츠는 GIF입니다. 빈 flags 필드는 오디오가 없는 GIF를 나타냅니다.
bg_color	string 콘텐츠의 가장 일반적인 배경 픽셀 색상
url	string tenor.com에서 게시물을 볼 수 있는 짧은 URL입니다.

카테고리 객체

다음 표에서는 카테고리 객체의 속성에 대한 세부정보를 제공합니다.

속성
searchterm	string 카테고리에 해당하는 검색어입니다. 검색어는 해당 요청의 locale와 일치하도록 번역됩니다.
path	string 사용자가 카테고리를 선택하는 경우 요청할 검색 URL입니다.
image	string 카테고리의 예시 GIF에 대한 미디어 소스의 URL
name	string 이미지 위에 오버레이할 카테고리 이름입니다. 이름은 해당 요청의 locale에 맞게 번역됩니다.

미디어 객체

다음 표에서는 미디어 객체의 속성을 자세히 설명합니다.

속성
url	string 미디어 소스의 URL
dims	int[] 미디어의 너비와 높이(단위: 픽셀)
duration	float 콘텐츠의 한 루프에 걸리는 시간을 초 단위로 나타냅니다. 콘텐츠가 정적인 경우 기간은 0로 설정됩니다.
size	int 파일 크기(바이트)

콘텐츠 형식

Tenor API는 다양한 크기로 다음 5가지 기본 형식을 제공합니다.

• GIF
• MP4
• WebM
• 투명 WebP
• 투명 GIF

MP4 및 WebM 형식은 클립을 한 번만 재생합니다. 단, loopedmp4는 클립을 몇 번 재생합니다. GIF 형식은 클립을 연속 루프로 재생합니다. 투명 형식은 스티커 콘텐츠용이며 GIF 검색 결과에서는 사용할 수 없습니다.

형식 유형

다음 표에는 Tenor에 사용할 수 있는 미디어 형식 유형이 자세히 나와 있습니다.

형식 유형
preview	해상도 및 크기: 고품질 단일 프레임 GIF 형식, GIF 형식보다 크기가 작음 측정기준: 원본 업로드 측정기준 (제한 없음) 사용 참고사항: 콘텐츠의 첫 번째 프레임으로 만드세요. 썸네일 미리보기로 사용하기 위한 것입니다. 이 형식은 GIF 및 스티커에서 지원됩니다.
gif	해상도 및 크기: 고화질 GIF 형식, 사용 가능한 가장 큰 파일 크기 측정기준: 원본 업로드 측정기준 (제한 없음) 사용 참고: 데스크톱에서 GIF 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
mediumgif	해상도 및 크기: GIF 형식의 크기가 약간 감소함 크기: 원본 업로드 크기 (제한 없음)이지만 압축률이 훨씬 높음 사용 참고: 데스크톱의 GIF 미리보기에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
tinygif	해상도 및 크기: GIF 형식의 크기가 줄어듭니다. 크기: 최대 너비 220픽셀 가로세로 비율을 유지하기 위해 높이가 조정됩니다. 사용 참고사항: 모바일에서 GIF 미리보기 및 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
nanogif	해상도 및 크기: GIF 형식의 최소 크기 크기: 최대 높이 90픽셀 가로세로 비율을 유지하기 위해 너비가 조정됩니다. 사용 참고: 모바일에서 GIF 미리보기에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
mp4	해상도 및 크기: 최고 품질 동영상 형식, 동영상 형식 중 가장 크지만 GIF보다는 작음 크기: GIF와 비슷하지만 동영상 컨테이너 사양에 맞게 패딩이 적용됩니다. 동영상 컨테이너 사양은 보통 8픽셀 단위입니다. 사용 참고사항: 데스크톱에서 MP4 미리보기 및 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
loopedmp4	해상도 및 크기: 최고 품질 동영상 형식, MP4보다 크기가 큼 크기: GIF와 비슷하지만 동영상 컨테이너 사양에 맞게 패딩이 적용됩니다. 동영상 컨테이너 사양은 보통 8픽셀 단위입니다. 사용 참고사항: 동영상 클립을 한 번만 실행하는 대신 여러 번 실행하려면 MP4 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
tinymp4	해상도 및 크기: MP4 형식의 크기가 줄어듦 크기: 너비와 높이가 가변적이며 최대 경계 상자는 320x320픽셀입니다. 사용 참고사항: 모바일에서 MP4 미리보기 및 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
nanomp4	해상도 및 크기: MP4 형식의 최소 크기 크기: 너비와 높이가 가변적이며 최대 경계 상자는 150x150픽셀입니다. 사용 참고사항: 모바일의 MP4 미리보기에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
webm	해상도 및 크기: 품질이 낮은 동영상 형식, MP4보다 크기가 작음 크기: GIF와 비슷하지만 동영상 컨테이너 사양에 맞게 패딩이 적용됩니다. 동영상 컨테이너 사양은 보통 8픽셀 단위입니다. 사용 참고사항: 데스크톱에서 WebM 미리보기 및 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
tinywebm	해상도 및 크기: WebM 형식의 크기가 줄어듦 크기: 너비와 높이가 가변적이며 최대 경계 상자는 320x320픽셀입니다. 사용 참고사항: 모바일에서 GIF 공유에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
nanowebm	해상도 및 크기: WebM 형식의 최소 크기 크기: 가변 너비와 높이, 최대 경계 상자 150x150픽셀 사용 참고: 모바일에서 GIF 미리보기에 이 크기를 사용하세요. 이 형식은 GIF 및 스티커에서 지원됩니다.
webp_transparent	해상도 및 크기: 고품질 WebP 스티커 형식, 사용 가능한 최대 파일 크기 측정기준: 원본 업로드 측정기준 (제한 없음) 사용 참고: 대역폭이 높은 사용자의 스티커 공유에 이 크기를 사용하세요. 이 형식은 스티커에 지원됩니다.
tinywebp_transparent	해상도 및 크기: WebP 스티커 형식의 크기가 줄어들었으며 최대 크기는 500KB입니다. 크기: 최대 220x220픽셀, 가로세로 비율을 유지하기 위해 높이가 조정됩니다. 사용 참고: 대역폭이 높은 사용자의 스티커 미리보기와 대역폭이 낮은 사용자의 공유에 이 크기를 사용합니다. 이 형식은 스티커에 지원됩니다.
nanowebp_transparent	해상도 및 크기: WebP 스티커 형식의 최소 크기, 최대 크기 100KB 크기: 최대 90x90픽셀이며 가로세로 비율을 유지하기 위해 너비가 조정됩니다. 사용 참고사항: 대역폭이 낮은 사용자의 스티커 미리보기에 이 크기를 사용하세요. 이 형식은 스티커에 지원됩니다.
gif_transparent	해상도 및 크기: 고품질 GIF 스티커 형식, 사용 가능한 가장 큰 파일 크기 측정기준: 원본 업로드 측정기준 (제한 없음) 사용 참고: 대역폭이 높은 사용자의 스티커 공유에 이 크기를 사용하세요. 이 형식은 스티커에 지원됩니다.
tinygif_transparent	해상도 및 크기: GIF 스티커 형식의 크기가 줄어들며 최대 크기는 500KB입니다. 크기: 최대 220x220픽셀, 가로세로 비율을 유지하기 위해 높이가 조정됩니다. 사용 참고: 대역폭이 높은 사용자의 스티커 미리보기와 대역폭이 낮은 사용자의 공유에 이 크기를 사용합니다. 이 형식은 스티커에 지원됩니다.
nanogif_transparent	해상도 및 크기: GIF 스티커 형식의 최소 크기, 최대 크기 100KB 크기: 최대 90x90픽셀이며 가로세로 비율을 유지하기 위해 너비가 조정됩니다. 사용 참고사항: 대역폭이 낮은 사용자의 스티커 미리보기에 이 크기를 사용하세요. 이 형식은 스티커에 지원됩니다.

권장사항

• 모바일의 경우 미리보기에는 nano 또는 tiny 크기의 파일을 사용하고 공유에는 tiny 크기의 파일을 사용합니다.
• 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 오류 형식으로 오류를 반환합니다. 자세한 내용은 오류를 참고하세요.