응답 객체 및 오류

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

응답 객체

다음 표에서는 응답 객체의 속성에 대한 세부정보를 제공합니다.

속성
created

float

이 게시물이 생성된 시점을 나타내는 Unix 타임스탬프입니다.

hasaudio

boolean

이 게시물에 오디오가 포함된 경우 true를 반환합니다.

id

string

Tenor 결과 식별자

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

쉼표로 구분된 목록. 콘텐츠가 스티커 이미지인지 정적 이미지인지 또는 오디오와 같거나 그 조합인지를 나타냅니다. stickerstatic가 없으면 콘텐츠는 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는 다양한 크기로 다음의 다섯 가지 기본 형식을 제공합니다.

  • 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 또는 아주 작은 파일을 사용하고 공유에는 아주 작은 파일을 사용합니다.
  • 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 오류 형식으로 오류를 반환합니다. 자세한 내용은 오류를 참조하세요.