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

Trang này cung cấp thông tin về nhiều phản hồi JSON và các đối tượng lỗi mà API Tenor 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 bài đăng này được tạo.
hasaudio

boolean

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

string

Mã nhận dạng kết quả Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

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

string[]

Mảng thẻ cho bài đăng
title

string

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

string

Mô tả nội dung bằng văn bản.

Bạn nên 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 chứa phụ đề.
flags

string

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

string

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

string

Một 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 loại. Cụm từ tìm kiếm sẽ được dịch để khớp với locale của yêu cầu tương ứng.
path

string

URL tìm kiếm để yêu cầu xem người dùng có chọn danh mục hay không
image

string

URL tới nguồn phương tiện cho ảnh GIF mẫu 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 phương tiện

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ương tiện:

Thuộc tính
url

string

URL tới nguồn phương tiện truyền thông
dims

int[]

Chiều rộng và chiều cao của phương tiện bằng pixel
duration

float

Biểu thị thời gian tính bằng giây cho một vòng lặp nội dung. Nếu nội dung tĩnh, thì thời lượng sẽ đượ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 năm định dạng cơ sở 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 (phát vài lần đoạn video). Định dạng GIF phát đoạn video trên một vòng lặp liên tục. Các định dạng trong suốt này dành cho nội dung hình dán và không xuất hiện trong kết quả tìm kiếm ảnh GIF.

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 có sẵn cho Tenor:

Loại định dạng
preview
  • Độ phân giải và kích thước: Định dạng GIF khung hình đơn chất lượng cao; kích thước nhỏ hơn định dạng GIF
  • Thứ nguyên: Thứ nguyên tải lên ban đầu (không giới hạn)
  • Ghi chú sử dụng: Đặt thẻ này làm khung đầu tiên của nội dung. Tệp này dùng để xem trước dưới dạng hình thu nhỏ.

Định dạng này được hỗ trợ 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 hiện có
  • Thứ nguyên: Thứ nguyên tải lên ban đầu (không giới hạn)
  • Ghi chú sử dụng: Sử dụng kích thước này cho chia sẻ GIF trên máy tính để bàn.

Định dạng này được hỗ trợ 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
  • Phương diện: Phương diện tải lên ban đầu (không có giới hạn) nhưng tỷ lệ nén cao hơn nhiều
  • Ghi 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 để bàn.

Định dạng này được hỗ trợ 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: Rộng đến 220 pixel. Chiều cao được chia tỷ lệ để duy trì tỷ lệ khung hình.
  • Ghi chú sử dụng: Sử dụng kích thước này cho xem trước và chia sẻ GIF trên thiết bị di động.

Định dạng này được hỗ trợ 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: Cao tối đa 90 pixel. Chiều rộng được điều chỉnh theo tỷ lệ để duy trì tỷ lệ khung hình.
  • Ghi chú 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.

Định dạng này được hỗ trợ 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 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 vào để phù hợp với thông số kỹ thuật của vùng chứa video, thường là 8 pixel.
  • <br class = "ph-0-0"> Ghi chú sử dụng: <br class = "ph-1-1"> Sử dụng kích thước này cho bản xem trước và chia sẻ MP4 trên máy tính để bàn.

Định dạng này được hỗ trợ 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; có kích thước lớn hơn MP4
  • Kích thước: Tương tự như GIF nhưng được thêm vào để phù hợp với thông số kỹ thuật của vùng chứa video, thường là 8 pixel.
  • Ghi chú sử dụng: Sử dụng kích thước này cho các lượt chia sẻ MP4 khi bạn muốn đoạn video chạy vài lần thay vì chỉ một lần.

Định dạng này được hỗ trợ 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 có thể thay đổi, với hộp giới hạn tối đa là 320x320 pixel
  • Ghi chú sử dụng: Sử dụng kích thước này để xem trước và chia sẻ MP4 trên thiết bị di động.

Định dạng này được hỗ trợ 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
  • <br class = "ph-0-0"> Ghi chú sử dụng: <br class = "ph-1-1"> Sử dụng kích thước này cho bản xem trước MP4 trên thiết bị di động.

Định dạng này được hỗ trợ 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 vào để phù hợp với thông số kỹ thuật của vùng chứa video, thường là 8 pixel.
  • Ghi chú sử dụng: Sử dụng kích thước này cho xem trước và chia sẻ WebM trên máy tính.

Định dạng này được hỗ trợ 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: Thay đổi chiều rộng và chiều cao, với hộp giới hạn tối đa là 320x320 pixel
  • Ghi chú sử dụng: Sử dụng kích thước này cho chia sẻ GIF trên thiết bị di động.

Định dạng này được hỗ trợ 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: Thay đổi chiều rộng và chiều cao, với hộp giới hạn tối đa là 150x150 pixel
  • Ghi chú 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.

Định dạng này được hỗ trợ cho ảnh GIF và hình dán.
webp_transparent
  • Độ phân giải và kích thước: Định dạng hình dán WebP chất lượng cao; kích thước tệp lớn nhất hiện có
  • Thứ nguyên: Thứ nguyên tải lên ban đầu (không giới hạn)
  • Ghi chú sử dụng: Sử dụng kích thước này cho chia sẻ hình dán cho người dùng 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 hình 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 chia tỷ lệ để duy trì tỷ lệ co.
  • Lưu ý về mức sử dụng: Sử dụng kích thước này cho bản xem trước hình dán cho người dùng băng thông cao và chia sẻ cho người dùng 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 trong định dạng hình 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 chia tỷ lệ để duy trì tỷ lệ khung hình.
  • Ghi chú sử dụng: Sử dụng kích thước này cho bản xem trước hình dán cho người dùng 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 hình dán GIF chất lượng cao; kích thước tệp lớn nhất hiện có
  • Thứ nguyên: Thứ nguyên tải lên ban đầu (không giới hạn)
  • Ghi chú sử dụng: Sử dụng kích thước này cho chia sẻ hình dán cho người dùng 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 220x220 pixel, với chiều cao được chia tỷ lệ để duy trì tỷ lệ khung hình.
  • Lưu ý về mức sử dụng: Sử dụng kích thước này cho bản xem trước hình dán cho người dùng băng thông cao và chia sẻ cho người dùng 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 trong định dạng của 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 chia tỷ lệ để duy trì tỷ lệ khung hình.
  • Ghi chú sử dụng: Sử dụng kích thước này cho bản xem trước hình dán cho người dùng 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 sử dụng tệp có kích thước nano hoặc rất nhỏ để xem trước và tệp có kích thước nhỏ để chia sẻ.
  • Đặt thông số media_filter thành định dạng bạn định sử dụng. Điều này có thể làm giảm 70% kích thước phản hồi API.

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

Kích thước tệp cho mỗi định dạng nội dung phụ thuộc vào kích thước và độ dài của ảnh GIF cụ thể đã chọn. Do đó, hãy xem xét giá trị trung bình và giá trị trung bình được cung cấp trong bảng sau làm hướng dẫn chung thay vì 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 mã phản hồi trạng thái HTTP dùng để cho biết mộ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ề các lỗi với mã phản hồi HTTP 4xx hoặc 5xx và ở định dạng lỗi Google API tiêu chuẩn. Để biết thông tin chi tiết, hãy xem phần Lỗi.