Antwortobjekte und -fehler

Auf dieser Seite finden Sie Informationen zu den verschiedenen JSON-Antwort- und Fehlerobjekten, die von der Tenor API verwendet werden.

Antwortobjekt

Die folgende Tabelle enthält Details zu den Attributen für Antwortobjekte:

Attribute
created

float

Ein UNIX-Zeitstempel, der angibt, wann dieser Beitrag erstellt wurde.
hasaudio

boolean

Gibt true zurück, wenn dieser Beitrag Audioinhalte enthält.
id

string

Tenor-Ergebnis-ID
media_formats

{ CONTENT_FORMAT : MEDIA_OBJECT }

Ein Dictionary mit einem Inhaltsformat als Schlüssel und einem Media-Objekt als Wert.
tags

string[]

Ein Array von Tags für den Beitrag
title

string

Der Titel des Beitrags
content_description

string

Eine Textbeschreibung des Inhalts.

Wir empfehlen, content_description für Bedienungshilfen für Nutzer zu verwenden.
itemurl

string

Die vollständige URL, unter der der Beitrag auf tenor.com aufgerufen werden kann.
hascaption

boolean

Gibt true zurück, wenn dieser Beitrag Untertitel enthält.
flags

string

Durch Kommas getrennte Liste, die angibt, ob es sich bei den Inhalten um einen Sticker oder ein statisches Bild handelt, ob sie Audio enthalten oder eine Kombination aus diesen Elementen sind. Wenn sticker und static nicht vorhanden sind, handelt es sich bei den Inhalten um ein GIF. Ein leeres Feld flags bedeutet ein GIF ohne Audio.
bg_color

string

Die häufigste Hintergrundpixelfarbe des Inhalts
url

string

Eine kurze URL, über die der Beitrag auf tenor.com aufgerufen werden kann.

Kategorieobjekt

Die folgende Tabelle enthält Details zu den Attributen für Kategorieobjekte:

Attribute
searchterm

string

Der Suchbegriff, der der Kategorie entspricht. Der Suchbegriff wird übersetzt, damit er mit der locale der entsprechenden Anfrage übereinstimmt.
path

string

Die Such-URL, die angefordert werden soll, wenn der Nutzer die Kategorie auswählt
image

string

Eine URL zur Medienquelle für das Beispiel-GIF der Kategorie
name

string

Kategoriename, der über das Bild gelegt werden soll. Der Name wird entsprechend der locale der entsprechenden Anfrage übersetzt.

Media-Objekt

In der folgenden Tabelle finden Sie Details zu den Attributen für Media-Objekte:

Attribute
url

string

Eine URL zur Medienquelle
dims

int[]

Breite und Höhe der Media in Pixeln
duration

float

Stellt die Zeit in Sekunden für einen Loop des Inhalts dar. Wenn die Inhalte statisch sind, wird die Dauer auf 0 festgelegt.
size

int

Größe der Datei in Byte

Inhaltsformate

Die API von Tenor bietet die folgenden fünf Basisformate in verschiedenen Größen:

  • GIF
  • MP4
  • WebM
  • Transparentes WebP
  • Transparentes GIF

Die Formate MP4 und WebM spielen ihren Clip nur einmal ab, mit Ausnahme von loopedmp4, bei dem der Clip mehrmals abgespielt wird. Das GIF-Format spielt seinen Clip in einer Endlosschleife ab. Die transparenten Formate sind für Stickerinhalte vorgesehen und nicht in GIF-Suchergebnissen verfügbar.

Formattypen

In der folgenden Tabelle finden Sie Details zu den verfügbaren Media-Formattypen für Tenor:

Formattypen
preview
  • Auflösung und Größe:GIF-Format mit Einzelbildern in hoher Qualität; kleiner als das GIF-Format
  • Abmessungen:Originalabmessungen des Uploads (keine Einschränkungen)
  • Verwendungshinweise:Dies sollte der erste Frame des Inhalts sein. Sie ist für die Verwendung als Thumbnail-Vorschau vorgesehen.

Dieses Format wird für GIFs und Sticker unterstützt.
gif
  • Auflösung und Größe:GIF-Format in hoher Qualität; größtmögliche Dateigröße
  • Abmessungen:Originalabmessungen des Uploads (keine Einschränkungen)
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für GIF-Freigaben auf dem Computer.

Dieses Format wird für GIFs und Sticker unterstützt.
mediumgif
  • Auflösung und Größe:Geringe Reduzierung der Größe des GIF-Formats
  • Größe:Originalgröße des Uploads (keine Einschränkungen), aber viel höhere Komprimierungsrate
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für GIF-Vorschauen auf dem Computer.

Dieses Format wird für GIFs und Sticker unterstützt.
tinygif
  • Auflösung und Größe:Die Größe des GIF-Formats wurde reduziert.
  • Abmessungen:Bis zu 220 Pixel breit. Die Höhe wird skaliert, um das Seitenverhältnis beizubehalten.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für GIF-Vorschauen und das Teilen von GIFs auf Mobilgeräten.

Dieses Format wird für GIFs und Sticker unterstützt.
nanogif
  • Auflösung und Größe:Kleinste Größe des GIF-Formats
  • Abmessungen:Bis zu 90 Pixel hoch. Die Breite wird skaliert, um das Seitenverhältnis beizubehalten.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für GIF-Vorschauen auf Mobilgeräten.

Dieses Format wird für GIFs und Sticker unterstützt.
mp4
  • Auflösung und Größe:Videoformat mit der höchsten Qualität; das größte der Videoformate, aber kleiner als GIF
  • Abmessungen:Ähnlich wie bei GIFs, aber mit Padding, um den Spezifikationen des Videocontainers zu entsprechen. Diese sind in der Regel 8-Pixel-Schritte.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für MP4-Vorschaubilder und Freigaben auf dem Computer.

Dieses Format wird für GIFs und Sticker unterstützt.
loopedmp4
  • Auflösung und Größe:Videoformat mit der höchsten Qualität; größer als MP4
  • Abmessungen:Ähnlich wie bei GIFs, aber mit Padding, um den Spezifikationen des Videocontainers zu entsprechen. Diese sind in der Regel 8-Pixel-Schritte.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für MP4-Freigaben, wenn der Videoclip mehrmals und nicht nur einmal wiedergegeben werden soll.

Dieses Format wird für GIFs und Sticker unterstützt.
tinymp4
  • Auflösung und Größe:Reduzierte Größe des MP4-Formats
  • Abmessungen:Variable Breite und Höhe, mit einem maximalen Begrenzungsrahmen von 320 × 320 Pixel
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für MP4-Vorschaubilder und Freigaben auf Mobilgeräten.

Dieses Format wird für GIFs und Sticker unterstützt.
nanomp4
  • Auflösung und Größe:Kleinste Größe des MP4-Formats
  • Abmessungen:Variable Breite und Höhe, mit einem maximalen Begrenzungsrahmen von 150 × 150 Pixel
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für MP4-Vorschaubilder auf Mobilgeräten.

Dieses Format wird für GIFs und Sticker unterstützt.
webm
  • Auflösung und Größe:Videoformat mit niedrigerer Qualität; kleiner als MP4
  • Abmessungen:Ähnlich wie bei GIFs, aber mit Padding, um den Spezifikationen des Videocontainers zu entsprechen. Diese sind in der Regel 8-Pixel-Schritte.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für WebM-Vorschaubilder und Freigaben auf dem Computer.

Dieses Format wird für GIFs und Sticker unterstützt.
tinywebm
  • Auflösung und Größe:Das WebM-Format hat eine geringere Größe.
  • Abmessungen:Variable Breite und Höhe, mit einem maximalen Begrenzungsrahmen von 320 × 320 Pixel
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für GIF-Freigaben auf Mobilgeräten.

Dieses Format wird für GIFs und Sticker unterstützt.
nanowebm
  • Auflösung und Größe:Kleinste Größe des WebM-Formats
  • Abmessungen:Variable Breite und Höhe, mit einem maximalen Begrenzungsrahmen von 150 × 150 Pixel
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für GIF-Vorschauen auf Mobilgeräten.

Dieses Format wird für GIFs und Sticker unterstützt.
webp_transparent
  • Auflösung und Größe:WebP-Stickerformat in hoher Qualität; größtmögliche Dateigröße
  • Abmessungen:Originalabmessungen des Uploads (keine Einschränkungen)
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für Sticker, die für Nutzer mit hoher Bandbreite freigegeben werden.

Dieses Format wird für Sticker unterstützt.
tinywebp_transparent
  • Auflösung und Größe:Das WebP-Stickerformat hat eine geringere Größe und darf maximal 500 KB groß sein.
  • Abmessungen:Bis zu 220 × 220 Pixel, Höhe wird skaliert, um das Seitenverhältnis beizubehalten.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für Sticker-Vorschaubilder für Nutzer mit hoher Bandbreite und für Freigaben für Nutzer mit niedriger Bandbreite.

Dieses Format wird für Sticker unterstützt.
nanowebp_transparent
  • Auflösung und Größe:Kleinste Größe des WebP-Stickerformats; maximale Größe von 100 KB
  • Abmessungen:Bis zu 90 × 90 Pixel, wobei die Breite skaliert wird, um das Seitenverhältnis beizubehalten.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für Sticker-Vorschauen für Nutzer mit geringer Bandbreite.

Dieses Format wird für Sticker unterstützt.
gif_transparent
  • Auflösung und Größe:GIF-Sticker im hochwertigen Format mit der größten verfügbaren Dateigröße
  • Abmessungen:Originalabmessungen des Uploads (keine Einschränkungen)
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für Sticker, die für Nutzer mit hoher Bandbreite freigegeben werden.

Dieses Format wird für Sticker unterstützt.
tinygif_transparent
  • Auflösung und Größe:Das GIF-Stickerformat hat eine reduzierte Größe und darf maximal 500 KB groß sein.
  • Abmessungen:Bis zu 220 × 220 Pixel, wobei die Höhe skaliert wird, um das Seitenverhältnis beizubehalten.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für Sticker-Vorschaubilder für Nutzer mit hoher Bandbreite und für Freigaben für Nutzer mit niedriger Bandbreite.

Dieses Format wird für Sticker unterstützt.
nanogif_transparent
  • Auflösung und Größe:Kleinste Größe des GIF-Stickerformats; maximale Größe von 100 KB
  • Abmessungen:Bis zu 90 × 90 Pixel, wobei die Breite skaliert wird, um das Seitenverhältnis beizubehalten.
  • Hinweise zur Verwendung:Verwenden Sie diese Größe für Sticker-Vorschauen für Nutzer mit geringer Bandbreite.

Dieses Format wird für Sticker unterstützt.

Best Practices

  • Verwenden Sie für Mobilgeräte Dateien in Nano- oder Tiny-Größe für Vorschauen und Dateien in Tiny-Größe für Freigaben.
  • Legen Sie für den Parameter media_filter die Formate fest, die Sie verwenden möchten. Dadurch kann die Größe der API-Antwort um 70 % reduziert werden.

Formatgrößen

Die Dateigröße für die einzelnen Inhaltsformate hängt von den Abmessungen und der Länge des ausgewählten GIFs ab. Die Mittelwerte und Mediane in der folgenden Tabelle sollten daher eher als allgemeine Richtlinien denn als feste Werte betrachtet werden.

Dateiformat Durchschnittliche Dateigröße (KB) Medianwert der Dateigröße (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

Antwortcodes

In der folgenden Tabelle sind die HTTP-Statusantwortcodes aufgeführt, die für eine erfolgreiche Anfrage verwendet werden:

HTTP-Statuscode
200 oder 202 OK oder akzeptiert

Fehler

Die API von Tenor gibt Fehler mit den HTTP-Antwortcodes 4xx oder 5xx und im standardmäßigen Google API-Fehlerformat zurück. Weitere Informationen finden Sie unter Fehler.