Đối tượng phản hồi và lỗi

Trang này cung cấp thông tin về các đối tượng phản hồi và lỗi JSON mà Tenor API sử dụng.

Đối tượng phản hồi

Bảng sau đây cung cấp thông tin chi tiết về các thuộc tính cho Đối tượng phản hồi:

Thuộc tính
created

float

Dấu thời gian Unix biểu thị thời điểm tạo bài đăng này.
hasaudio

boolean

Trả về true nếu bài đăng này có chứa âm thanh.
id

string

Giá trị nhận dạng kết quả Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Một từ điển có định dạng nội dung làm khoá và Đối tượng đa phương tiện làm giá trị.
tags

string[]

Một mảng các thẻ cho bài đăng
title

string

Tiêu đề của bài đăng
content_description

string

Nội dung mô tả bằng văn bản về nội dung.

Bạn nên sử dụng content_description cho các tính năng hỗ trợ tiếp cận của người dùng.
itemurl

string

URL đầy đủ để xem bài đăng trên tenor.com.
hascaption

boolean

Trả về true nếu bài đăng này có phụ đề.
flags

string

Danh sách được phân tách bằng dấu phẩy để cho biết nội dung là hình dán hay hình ảnh tĩnh, có âm thanh hay là tổ hợp của các yếu tố này. Nếu không có sticker và static, thì nội dung đó là ảnh GIF. Trường flags trống biểu thị một ảnh GIF không có âm thanh.
bg_color

string

Màu pixel nền phổ biến nhất của nội dung
url

string

URL ngắn để xem bài đăng trên tenor.com.

Đối tượng danh mục

Bảng sau đây cung cấp thông tin chi tiết về các thuộc tính cho Đối tượng danh mục:

Thuộc tính
searchterm

string

Cụm từ tìm kiếm tương ứng với danh mục. Cụm từ tìm kiếm được dịch để khớp với locale của yêu cầu tương ứng.
path

string

URL tìm kiếm cần yêu cầu nếu người dùng chọn danh mục
image

string

URL đến nguồn nội dung nghe nhìn cho ảnh GIF minh hoạ của danh mục
name

string

Tên danh mục để phủ lên hình ảnh. Tên được dịch để khớp với locale của yêu cầu tương ứng.

Đối tượng nội dung nghe nhìn

Bảng sau đây cung cấp thông tin chi tiết về các thuộc tính của Đối tượng đa phương tiện:

Thuộc tính
url

string

URL đến nguồn nội dung nghe nhìn
dims

int[]

Chiều rộng và chiều cao của nội dung nghe nhìn tính bằng pixel
duration

float

Biểu thị thời gian tính bằng giây cho một vòng lặp của nội dung. Nếu nội dung là tĩnh, thì thời lượng được đặt thành 0.
size

int

Kích thước của tệp tính bằng byte

Định dạng nội dung

API của Tenor cung cấp 5 định dạng cơ bản sau đây với nhiều kích thước:

  • GIF
  • MP4
  • WebM
  • WebP trong suốt
  • Ảnh GIF trong suốt

Định dạng MP4 và WebM chỉ phát đoạn video một lần, ngoại trừ loopedmp4, định dạng này phát đoạn video vài lần. Định dạng GIF phát đoạn video của mình theo một vòng lặp liên tục. Các định dạng trong suốt là dành cho nội dung hình dán và không có trong kết quả tìm kiếm ảnh GIF.

Các loại định dạng

Bảng sau đây cung cấp thông tin chi tiết về các loại định dạng nội dung nghe nhìn hiện có cho Tenor:

Các loại định dạng
preview
  • Độ phân giải và kích thước: Định dạng GIF một khung hình chất lượng cao; kích thước nhỏ hơn định dạng GIF
  • Kích thước: Kích thước tải lên ban đầu (không giới hạn)
  • Lưu ý khi sử dụng: Đặt khung hình này làm khung hình đầu tiên của nội dung. Thành phần này được dùng làm bản xem trước hình thu nhỏ.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
gif
  • Độ phân giải và kích thước: Định dạng GIF chất lượng cao; kích thước tệp lớn nhất có thể
  • Kích thước: Kích thước tải lên ban đầu (không giới hạn)
  • Lưu ý về cách sử dụng: Sử dụng kích thước này cho ảnh GIF được chia sẻ trên máy tính.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
mediumgif
  • Độ phân giải và kích thước: Giảm nhẹ kích thước của định dạng GIF
  • Kích thước: Kích thước tải lên ban đầu (không giới hạn) nhưng tỷ lệ nén cao hơn nhiều
  • Lưu ý về cách sử dụng: Sử dụng kích thước này cho bản xem trước GIF trên máy tính.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
tinygif
  • Độ phân giải và kích thước: Giảm kích thước của định dạng GIF
  • Kích thước: Chiều rộng tối đa là 220 pixel. Chiều cao được điều chỉnh theo tỷ lệ để duy trì tỷ lệ khung hình.
  • Lưu ý về việc sử dụng: Sử dụng kích thước này cho ảnh GIF xem trước và chia sẻ trên thiết bị di động.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
nanogif
  • Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng GIF
  • Kích thước: Chiều cao tối đa là 90 pixel. Chiều rộng được điều chỉnh theo tỷ lệ để duy trì tỷ lệ khung hình.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước GIF trên thiết bị di động.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
mp4
  • Độ phân giải và kích thước: Định dạng video có chất lượng cao nhất; lớn nhất trong số các định dạng video, nhưng nhỏ hơn GIF
  • Kích thước: Tương tự như GIF nhưng được thêm khoảng đệm để phù hợp với quy cách của vùng chứa video, thường là tăng thêm 8 pixel.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước và chia sẻ tệp MP4 trên máy tính.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
loopedmp4
  • Độ phân giải và kích thước: Định dạng video có chất lượng cao nhất; kích thước lớn hơn MP4
  • Kích thước: Tương tự như GIF nhưng được thêm khoảng đệm để phù hợp với quy cách của vùng chứa video, thường là tăng thêm 8 pixel.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho nội dung chia sẻ ở định dạng MP4 khi bạn muốn đoạn video chạy vài lần thay vì chỉ một lần.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
tinymp4
  • Độ phân giải và kích thước: Giảm kích thước của định dạng MP4
  • Kích thước: Chiều rộng và chiều cao thay đổi, với hộp giới hạn tối đa là 320x320 pixel
  • Lưu ý về cách sử dụng: Sử dụng kích thước này cho bản xem trước và nội dung chia sẻ MP4 trên thiết bị di động.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
nanomp4
  • Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng MP4
  • Kích thước: Chiều rộng và chiều cao có thể thay đổi, với hộp giới hạn tối đa là 150x150 pixel
  • Lưu ý về việc sử dụng: Sử dụng kích thước này cho bản xem trước MP4 trên thiết bị di động.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
webm
  • Độ phân giải và kích thước: Định dạng video có chất lượng thấp hơn; kích thước nhỏ hơn MP4
  • Kích thước: Tương tự như GIF nhưng được thêm khoảng đệm để phù hợp với quy cách của vùng chứa video, thường là tăng thêm 8 pixel.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước và chia sẻ tệp WebM trên máy tính.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
tinywebm
  • Độ phân giải và kích thước: Giảm kích thước của định dạng WebM
  • Kích thước: Chiều rộng và chiều cao thay đổi, với hộp giới hạn tối đa là 320x320 pixel
  • Lưu ý về cách sử dụng: Sử dụng kích thước này cho ảnh GIF được chia sẻ trên thiết bị di động.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
nanowebm
  • Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng WebM
  • Kích thước: Chiều rộng và chiều cao có thể thay đổi, với hộp giới hạn tối đa là 150x150 pixel
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước GIF trên thiết bị di động.

Hệ thống hỗ trợ định dạng này cho ảnh GIF và hình dán.
webp_transparent
  • Độ phân giải và kích thước: Định dạng nhãn dán WebP chất lượng cao; kích thước tệp lớn nhất có thể
  • Kích thước: Kích thước tải lên ban đầu (không giới hạn)
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho các lượt chia sẻ hình dán đối với người dùng có băng thông cao.

Định dạng này được hỗ trợ cho hình dán.
tinywebp_transparent
  • Độ phân giải và kích thước: Giảm kích thước của định dạng nhãn dán WebP; kích thước tối đa là 500 KB
  • Kích thước: Tối đa 220x220 pixel, chiều cao được điều chỉnh để duy trì tỷ lệ khung hình.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông cao và nội dung chia sẻ đối với người dùng có băng thông thấp.

Định dạng này được hỗ trợ cho hình dán.
nanowebp_transparent
  • Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng nhãn dán WebP; kích thước tối đa là 100 KB
  • Kích thước: Tối đa 90x90 pixel, với chiều rộng được điều chỉnh để giữ nguyên tỷ lệ khung hình.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông thấp.

Định dạng này được hỗ trợ cho hình dán.
gif_transparent
  • Độ phân giải và kích thước: Định dạng nhãn dán GIF chất lượng cao; kích thước tệp lớn nhất có thể
  • Kích thước: Kích thước tải lên ban đầu (không giới hạn)
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho các lượt chia sẻ hình dán đối với người dùng có băng thông cao.

Định dạng này được hỗ trợ cho hình dán.
tinygif_transparent
  • Độ phân giải và kích thước: Giảm kích thước của định dạng hình dán GIF; kích thước tối đa là 500 KB
  • Kích thước: Tối đa 220 x 220 pixel, với chiều cao được điều chỉnh để giữ nguyên tỷ lệ khung hình.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông cao và nội dung chia sẻ đối với người dùng có băng thông thấp.

Định dạng này được hỗ trợ cho hình dán.
nanogif_transparent
  • Độ phân giải và kích thước: Kích thước nhỏ nhất của định dạng hình dán GIF; kích thước tối đa là 100 KB
  • Kích thước: Tối đa 90x90 pixel, với chiều rộng được điều chỉnh để giữ nguyên tỷ lệ khung hình.
  • Lưu ý khi sử dụng: Sử dụng kích thước này cho bản xem trước hình dán đối với người dùng có băng thông thấp.

Định dạng này được hỗ trợ cho hình dán.

Các phương pháp hay nhất

  • Đối với thiết bị di động, hãy dùng các tệp có kích thước siêu nhỏ hoặc rất nhỏ để xem trước và các tệp có kích thước rất nhỏ để chia sẻ.
  • Đặt tham số media_filter thành các định dạng mà bạn dự định sử dụng. Điều này có thể giảm kích thước phản hồi API xuống 70%.

Kích thước định dạng

Kích thước tệp của mỗi định dạng nội dung phụ thuộc vào kích thước và thời lượng của GIF cụ thể mà bạn chọn. Do đó, hãy xem xét giá trị trung bình và trung vị được cung cấp trong bảng sau đây như các nguyên tắc chung thay vì các giá trị cố định.

Định dạng tệp Kích thước tệp trung bình (KB) Kích thước tệp trung bình (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

Mã phản hồi

Bảng sau đây cung cấp các mã trạng thái phản hồi HTTP được dùng để cho biết yêu cầu thành công:

Mã trạng thái HTTP
200 hoặc 202 OK hoặc được chấp nhận

Lỗi

API của Tenor trả về lỗi bằng mã phản hồi HTTP 4xx hoặc 5xx và ở định dạng lỗi API tiêu chuẩn của Google. Để biết thông tin chi tiết, hãy xem phần Lỗi.