Đố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. Lưu ý: Chỉ các định dạng video mới hỗ trợ âm thanh. Định dạng tệp hình ảnh GIF không được chứa thông tin â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.