Objek respons dan error

Halaman ini memberikan informasi tentang berbagai objek error dan respons JSON yang digunakan oleh Tenor API.

Objek respons

Tabel berikut memberikan detail tentang properti untuk Objek Respons:

Properti
created

float

Stempel waktu Unix yang menunjukkan kapan postingan ini dibuat.
hasaudio

boolean

Menampilkan true jika postingan ini berisi audio.
id

string

ID hasil Tenor
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Kamus dengan format konten sebagai kunci dan Objek Media sebagai nilai.
tags

string[]

Array tag untuk postingan
title

string

Judul postingan
content_description

string

Deskripsi tekstual konten.

Sebaiknya Anda menggunakan content_description untuk fitur aksesibilitas pengguna.
itemurl

string

URL lengkap untuk melihat postingan di tenor.com.
hascaption

boolean

Menampilkan true jika postingan ini berisi teks.
flags

string

Daftar yang dipisahkan koma untuk menunjukkan apakah konten berupa stiker atau gambar statis, memiliki audio, atau merupakan kombinasi dari semuanya. Jika sticker dan static tidak ada, berarti kontennya adalah GIF. Kolom flags yang kosong menandakan GIF tanpa audio.
bg_color

string

Warna piksel latar belakang konten yang paling umum
url

string

URL singkat untuk melihat postingan di tenor.com.

Objek kategori

Tabel berikut memberikan detail tentang properti untuk Objek Kategori:

Properti
searchterm

string

Istilah penelusuran yang sesuai dengan kategori. Istilah penelusuran diterjemahkan agar cocok dengan locale permintaan yang sesuai.
path

string

URL penelusuran yang akan diminta jika pengguna memilih kategori
image

string

URL ke sumber media untuk GIF contoh kategori
name

string

Nama kategori yang akan ditampilkan di atas gambar. Nama diterjemahkan agar sesuai dengan locale permintaan yang sesuai.

Objek media

Tabel berikut memberikan detail tentang properti untuk Objek Media:

Properti
url

string

URL ke sumber media
dims

int[]

Lebar dan tinggi media dalam piksel
duration

float

Menyatakan waktu dalam detik untuk satu loop konten. Jika konten statis, durasi ditetapkan ke 0.
size

int

Ukuran file dalam byte

Format konten

API Tenor menawarkan lima format dasar berikut dalam berbagai ukuran:

  • GIF
  • MP4
  • WebM
  • WebP Transparan
  • GIF transparan

Format MP4 dan WebM hanya memutar klipnya satu kali, kecuali loopedmp4, yang memutar klip beberapa kali. Format GIF memutar klipnya dalam loop berkelanjutan. Format transparan ditujukan untuk konten stiker dan tidak tersedia di hasil penelusuran GIF.

Jenis format

Tabel berikut memberikan detail tentang jenis format media yang tersedia untuk Tenor:

Jenis format
preview
  • Resolusi dan ukuran: Format GIF frame tunggal berkualitas tinggi; ukuran lebih kecil daripada format GIF
  • Dimensi: Dimensi upload asli (tanpa batas)
  • Catatan penggunaan: Jadikan ini sebagai frame pertama konten. Tujuannya adalah untuk digunakan sebagai pratinjau thumbnail.

Format ini didukung untuk GIF dan stiker.
gif
  • Resolusi dan ukuran: Format GIF berkualitas tinggi; ukuran file terbesar yang tersedia
  • Dimensi: Dimensi upload asli (tanpa batas)
  • Catatan penggunaan: Gunakan ukuran ini untuk berbagi GIF di desktop.

Format ini didukung untuk GIF dan stiker.
mediumgif
  • Resolusi dan ukuran: Pengurangan kecil pada ukuran format GIF
  • Dimensi: Dimensi upload asli (tanpa batas), tetapi rasio kompresi jauh lebih tinggi
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau GIF di desktop.

Format ini didukung untuk GIF dan stiker.
tinygif
  • Resolusi dan ukuran: Mengurangi ukuran format GIF
  • Dimensi: Lebar hingga 220 piksel. Tinggi diskalakan untuk mempertahankan rasio aspek.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau dan berbagi GIF di perangkat seluler.

Format ini didukung untuk GIF dan stiker.
nanogif
  • Resolusi dan ukuran: Ukuran terkecil format GIF
  • Dimensi: Tinggi hingga 90 piksel. Lebar diskalakan untuk mempertahankan rasio aspek.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau GIF di perangkat seluler.

Format ini didukung untuk GIF dan stiker.
mp4
  • Resolusi dan ukuran: Format video berkualitas tertinggi; terbesar dari format video, tetapi lebih kecil dari GIF
  • Dimensi: Mirip dengan GIF, tetapi diberi padding agar sesuai dengan spesifikasi penampung video, yang biasanya dalam kelipatan 8 piksel.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau dan berbagi MP4 di desktop.

Format ini didukung untuk GIF dan stiker.
loopedmp4
  • Resolusi dan ukuran: Format video berkualitas tertinggi; berukuran lebih besar daripada MP4
  • Dimensi: Mirip dengan GIF, tetapi diberi padding agar sesuai dengan spesifikasi penampung video, yang biasanya dalam kelipatan 8 piksel.
  • Catatan penggunaan: Gunakan ukuran ini untuk berbagi MP4 jika Anda ingin klip video diputar beberapa kali, bukan hanya sekali.

Format ini didukung untuk GIF dan stiker.
tinymp4
  • Resolusi dan ukuran: Ukuran format MP4 yang dikurangi
  • Dimensi: Lebar dan tinggi variabel, dengan kotak pembatas maksimum 320x320 piksel
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau dan berbagi MP4 di perangkat seluler.

Format ini didukung untuk GIF dan stiker.
nanomp4
  • Resolusi dan ukuran: Ukuran terkecil format MP4
  • Dimensi: Lebar dan tinggi bervariasi, dengan kotak pembatas maksimum 150x150 piksel
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau MP4 di perangkat seluler.

Format ini didukung untuk GIF dan stiker.
webm
  • Resolusi dan ukuran: Format video berkualitas lebih rendah; ukuran lebih kecil daripada MP4
  • Dimensi: Mirip dengan GIF, tetapi diberi padding agar sesuai dengan spesifikasi penampung video, yang biasanya dalam kelipatan 8 piksel.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau dan berbagi WebM di desktop.

Format ini didukung untuk GIF dan stiker.
tinywebm
  • Resolusi dan ukuran: Ukuran format WebM yang dikurangi
  • Dimensi: Lebar dan tinggi variabel, dengan kotak pembatas maksimum 320x320 piksel
  • Catatan penggunaan: Gunakan ukuran ini untuk berbagi GIF di perangkat seluler.

Format ini didukung untuk GIF dan stiker.
nanowebm
  • Resolusi dan ukuran: Ukuran terkecil format WebM
  • Dimensi: Lebar dan tinggi bervariasi, dengan kotak pembatas maksimum 150x150 piksel
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau GIF di perangkat seluler.

Format ini didukung untuk GIF dan stiker.
webp_transparent
  • Resolusi dan ukuran: Format stiker WebP berkualitas tinggi; ukuran file terbesar yang tersedia
  • Dimensi: Dimensi upload asli (tanpa batas)
  • Catatan penggunaan: Gunakan ukuran ini untuk berbagi stiker bagi pengguna dengan bandwidth tinggi.

Format ini didukung untuk stiker.
tinywebp_transparent
  • Resolusi dan ukuran: Ukuran format stiker WebP yang dikurangi; ukuran maksimum 500 KB
  • Dimensi: Hingga 220x220 piksel, tinggi diskalakan untuk mempertahankan rasio aspek.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau stiker bagi pengguna dengan bandwidth tinggi dan berbagi bagi pengguna dengan bandwidth rendah.

Format ini didukung untuk stiker.
nanowebp_transparent
  • Resolusi dan ukuran: Ukuran terkecil format stiker WebP; ukuran maksimum 100 KB
  • Dimensi: Hingga 90x90 piksel, dengan lebar yang diskalakan untuk mempertahankan rasio aspek.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau stiker bagi pengguna dengan bandwidth rendah.

Format ini didukung untuk stiker.
gif_transparent
  • Resolusi dan ukuran: Format stiker GIF berkualitas tinggi; ukuran file terbesar yang tersedia
  • Dimensi: Dimensi upload asli (tanpa batas)
  • Catatan penggunaan: Gunakan ukuran ini untuk berbagi stiker bagi pengguna dengan bandwidth tinggi.

Format ini didukung untuk stiker.
tinygif_transparent
  • Resolusi dan ukuran: Ukuran format stiker GIF yang dikurangi; ukuran maksimum 500 KB
  • Dimensi: Hingga 220x220 piksel, dengan tinggi yang disesuaikan untuk mempertahankan rasio aspek.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau stiker bagi pengguna dengan bandwidth tinggi dan berbagi bagi pengguna dengan bandwidth rendah.

Format ini didukung untuk stiker.
nanogif_transparent
  • Resolusi dan ukuran: Ukuran terkecil format stiker GIF; ukuran maksimum 100 KB
  • Dimensi: Hingga 90x90 piksel, dengan lebar yang diskalakan untuk mempertahankan rasio aspek.
  • Catatan penggunaan: Gunakan ukuran ini untuk pratinjau stiker bagi pengguna dengan bandwidth rendah.

Format ini didukung untuk stiker.

Praktik terbaik

  • Untuk perangkat seluler, gunakan file berukuran nano atau sangat kecil untuk pratinjau dan file berukuran sangat kecil untuk berbagi.
  • Tetapkan parameter media_filter ke format yang ingin Anda gunakan. Hal ini dapat mengurangi ukuran respons API sebesar 70%.

Ukuran format

Ukuran file untuk setiap format konten bergantung pada dimensi dan durasi GIF tertentu yang dipilih. Oleh karena itu, pertimbangkan nilai rata-rata dan median yang diberikan dalam tabel berikut sebagai panduan umum, bukan nilai pasti.

Format file Ukuran file rata-rata (KB) Ukuran file median (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

Kode respons

Tabel berikut memberikan kode respons status HTTP yang digunakan untuk menunjukkan keberhasilan permintaan:

Kode status HTTP
200 atau 202 Oke atau diterima

Error

Tenor API menampilkan error dengan kode respons HTTP 4xx atau 5xx dan dalam format error Google API standar. Untuk mengetahui detailnya, lihat Error.