Transloadit
Preise
  • Datei-Uploads
  • Dateiimport
  • Stapelverarbeitung
  • Video-Encoding
  • Audio-Encoding
  • Bildverarbeitung
  • Dokumentenverarbeitung
  • Künstliche Intelligenz
  • Dateifilterung & Sicherheit
  • Medienkatalogisierung
  • Dateikomprimierung
  • Codeauswertung
  • Dateiexport
  • Smart CDN
  • Alle Services anzeigen
  • Integrationen entdecken
  • Live-Demos entdecken (English)
  • Uppy
  • TransloaditKit
  • Android-SDK
  • Node.js-SDK
  • Viewer für Next.js
  • Python-SDK
  • Ruby-SDK
  • Go-SDK
  • Java-SDK
  • PHP-SDK
  • Zapier
  • MCP-Server
  • Transloadit CLI
  • Terraform
  • Grundlagen
  • Bewährte Verfahren
  • Häufige Fragen
  • Robots
  • API-Endpunkte
  • Formate
  • Erstellen Sie Ihre erste App
  • Über Transloadit
  • Vergleiche
  • Open Source
  • Referenzen
  • Stellen (English)
  • Sicherheit
  • Beiträge
  • Aktuelles für Entwickler (English)
  • Tipps für Entwickler
  • Presse
  • Forschung (English)
  • Fallstudien
  • Lösungen
  • Leitfäden
  • Glossar
  • Rechtliches (English)
  • Werkzeuge
  • Wie wir Coursera helfen, Bildung für Millionen Menschen weltweit zugänglich zu machen
  • Transloadit-Support
  • Open-Source-Support
  • Service Level Agreement (English)
  • Buchen Sie eine Demo mit unseren Ingenieuren (English)
GrundlagenRobotsHäufige FragenAPI-EndpunkteFormateBewährte Verfahren
Themen
  • Endpunkte
  • Antwortcodes
  • Authentifizierung
  • Webhooks
  • Metadaten
  • API-Sicherheit
  • Ratenbegrenzung
  • Warteschlangen
  • Fortsetzbare Uploads
Authentifizierung
  • Bearer-Token erstellen
  • Neuen Auth Key erstellen
  • Liste der Auth Keys abrufen
  • Auth-Key-Scopes abrufen
  • Auth Key bearbeiten
  • Auth Key löschen
  • Secret für einen Auth Key abrufen
Assemblies
  • Neue Assembly erstellen
  • Assembly Status abrufen
  • Eine Assembly mit einer vorgegebenen ID erstellen
  • Änderungen einer Assembly live streamen
  • Laufende Assembly abbrechen
  • Eine Assembly erneut ausführen
  • Liste der Assemblies abrufen
  • Assembly-Status-Antwort
  • Assembly-Statistiken abrufen
Webhooks
  • Assembly Notifications abrufen
  • Assembly Notification erneut senden
Abrechnung
  • Monatsrechnung abrufen
Warteschlangen
  • Derzeit genutzte Priority Job Slots abrufen
  • Statistiken zu Priority Job Slots abrufen
Fortsetzbare Uploads
  • Funktionen des tus-Protokolls ermitteln
  • Neuen tus-Upload erstellen
  • Offset eines tus-Uploads abrufen
  • tus-Dateidaten hochladen
  • tus-Upload beenden
  • tus-Upload herunterladen
Template-Zugangsdaten
  • Neue Template-Zugangsdaten erstellen
  • Template-Zugangsdaten abrufen
  • Template-Zugangsdaten bearbeiten
  • Template-Zugangsdaten löschen
  • Liste der Template-Zugangsdaten abrufen
  • Typen von Template-Zugangsdaten abrufen
Templates
  • Neues Template erstellen
  • Template abrufen
  • Template bearbeiten
  • Template löschen
  • Liste der Templates abrufen
  • Ausführungsverlauf des Cron-Templates abrufen alpha
Verwaltung digitaler Assets
  • DAM-Asset verschieben oder umbenennen alpha
  • DAM-Asset löschen alpha
  • Mehrere DAM-Assets verschieben alpha
  • Mehrere DAM-Assets löschen alpha
  • Eine Datei oder einen Ordner im Speicher verschieben alpha
  • Ein Asset aus dem Speicher abrufen
  • Gespeicherte Assets auflisten

Metadaten

Viele Dateien enthalten interessante Informationen über ihren Inhalt. Diese werden als „Metadaten“ bezeichnet. Transloadit extrahiert diese Metadaten automatisch für alle hochgeladenen, importierten und verarbeiteten Dateien.

Jede Datei enthält mindestens Informationen wie die folgenden:

{
  "id": "ae52b7f8c1b3426e8c29ea0a9daf8306",
  "name": "straw-apple.jpg",
  "basename": "straw-apple",
  "ext": "jpg",
  "size": 92230,
  "mime": "image/jpeg",
  "type": "image",
  "field": "test_file",
  "url": "http://tmp.maynard.transloadit.com/upload/1324a798a99fce7f5f8289a95a74f02b.jpg",
  "original_id": "4af24fb2595f44809f3adc2f77bc9bfa",
  "meta": {
    // …
  }
}

Welche Informationen wir extrahieren können, hängt von der Mediendatei und ihrem Typ ab, aber auch davon, wer sie erstellt hat. Stammt sie von einem iPhone, ist wahrscheinlich latitude für die Geopositionierung enthalten. Zu den häufigeren Schlüsseln gehören height und duration.

Um zu sehen, welche Informationen wir aus den Dateien extrahieren können, die Sie uns schicken, können Sie eine unserer Demos EN (English) ausprobieren und nach dem Hochladen einer Datei unsere Antwort untersuchen.

id

Eine zufällige und eindeutige ID, die Transloadit intern zur Nachverfolgung der Datei verwendet.

name

Der Name der Datei. Transloadit ändert die in diesem Feld verwendete Dateiendung, wenn die Datei bei der Verarbeitung in ein anderes Format umgewandelt wird.

basename

Der Name der Datei ohne Endung.

ext

Die Endung der Datei. Kann null sein, wenn keine Endung ermittelt wurde, oder ein leerer String bei einem Namen ohne Endung.

size

Die Größe der Datei in Byte.

mime

Der für diese Datei ermittelte MIME-Typ.

type

Eine abstrakte Kategorie, die die Datei beschreibt. Bekannte Werte sind "audio", "document", "image", "office", "pdf", "swf", "video", "xls" oder null, wenn keine Kategorie erkannt wurde. Konsumenten sollten auch andere Strings akzeptieren, damit künftige Kategorien kompatibel bleiben.

field

Der Name des Formularfelds, über das diese Datei übermittelt wurde.

url

Eine URL, unter der die Datei heruntergeladen werden kann, oder null, wenn keine Auslieferungs-URL verfügbar ist. Temporäre URLs auf unseren Servern laufen nach einigen Stunden ab; exportieren Sie Dateien zur späteren Verwendung in einen Speicher. /transloadit/store setzt für url/ssl_url eine signierte Smart CDN URL oder ohne Schlüssel null. Bewahren Sie den zurückgegebenen Workspace, asset_id und version_id als dauerhafte Referenz auf, vorbehaltlich Zugriffsrechten und Aufbewahrungsregeln. /transloadit/import akzeptiert asset_id mit optionaler version_id oder einen veränderlichen path. Weder eine temporäre URL noch die id der Verarbeitungsdatei ist eine dauerhafte Storage-Referenz.

original_id

Die eindeutige ID der ursprünglich hochgeladenen Datei, aus der diese Datei erzeugt wurde. Das ist nützlich, um nach mehreren Steps der Verarbeitung festzustellen, welche Datei eines Uploads mit mehreren Dateien zur Erzeugung einer bestimmten Datei verwendet wurde.

meta

Ein Objekt mit zusätzlichen, aus der Datei extrahierten Metadaten, wie unten gezeigt. Wiederholte Datums-Tags können als Listen ihrer ursprünglichen Werte zurückgegeben werden. Prüfen Sie den Typ des Werts, bevor Sie ihn als einzelnen Zeitstempel verwenden.

Bildmetadaten

Obwohl es von der jeweiligen Datei abhängt, können Dateien, deren type image ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:

width

Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeigeseitenverhältnis von ihrem Pixelseitenverhältnis abweicht, ist dies die vorgesehene Anzeigebreite.

height

Die Höhe des Mediums in Pixeln.

aspect_ratio

Das Seitenverhältnis des Bildes, also seine Breite geteilt durch seine Höhe. Ist 0, falls die Bildhöhe aus irgendeinem Grund 0 ist.

date_recorded

Datum und Uhrzeit der Aufnahme des Mediums. Ein einzelner gültiger Zeitstempel als String wird auf YYYY/MM/DD HH:MM:SS normalisiert. Ist eine Zeitzone angegeben, wird er in UTC/GMT umgerechnet und endet auf GMT. Nicht parsebare Zeitstempel-Strings werden zu null. Numerische Zeitstempel und Listen wiederholter Datums-Tags behalten ihre ursprünglichen Werte.

date_file_created

Der von den Medienmetadaten gemeldete Erstellungszeitstempel, sofern verfügbar.

date_file_modified

Der vom Dateisystem oder von eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.

title

Der Titel dieses Bildes, z. B. "Tree".

keywords

Aus den Metadaten der Datei extrahierte Schlüsselwörter: ein String, eine endliche Zahl oder ein Array, dessen Einträge Strings, endliche Zahlen oder boolesche Werte sein können. Zum Beispiel ["tree", "nature"]. Das Feld kann fehlen oder null sein. Prüfen Sie den Typ, bevor Sie darüber iterieren; Array-Einträge sind nicht zwingend Strings.

description

Eine Beschreibung dieses Bildes, z. B. "This tree is very old.".

location

Der Ort, an dem dieses Bild aufgenommen wurde, in der Regel die Straße, z. B. "Zingster Str. 32". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

creator

Die aus der Datei extrahierten Metadaten zum Urheber. Ursprüngliche skalare Werte, einschließlich Listen dieser Werte, bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

author

Der Autor, der das Bild aufgenommen hat. Manche Kameras befüllen dieses Feld statt creator.

copyright

Das Copyright-Metadatenfeld.

copyright_notice

Der aus der Datei extrahierte Copyright-Vermerk. Ursprüngliche skalare Werte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

city

Die Stadt, in der dieses Bild aufgenommen wurde, z. B. "Berlin". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

state

Das Bundesland bzw. der Bundesstaat, in dem dieses Bild aufgenommen wurde, z. B. "Berlin".

country

Das Land, in dem dieses Bild aufgenommen wurde, z. B. "Germany". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

country_code

Der in den Bildmetadaten erfasste Ländercode, z. B. "de" oder 528. String- und numerische Werte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

aperture

Die Blendeneinstellung für dieses Bild, z. B. 5.7.

exposure_compensation

Die Belichtungskorrektur für dieses Bild, z. B. "+4/3".

exposure_mode

Der Belichtungsmodus für dieses Bild, z. B. "Auto". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

exposure_time

Die Belichtungszeit für dieses Bild, z. B. "1/30".

flash

Die Blitzeinstellungen für dieses Bild, z. B. "Off, Did not fire". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

focal_length

Die Brennweite für dieses Bild, z. B. "55.0 mm". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

f_number

Die Blendenzahl für dieses Bild, z. B. 5.6.

iso

Der ISO-Wert für dieses Bild, z. B. 800.

light_value

Der Lichtwert für dieses Bild, z. B. 6.9.

metering_mode

Die Belichtungsmessmethode für dieses Bild, z. B. "Multi-segment". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

shutter_speed

Die Verschlusszeit für dieses Bild, z. B. "1/32".

white_balance

Die Weißabgleichseinstellung für dieses Bild, z. B. "Manual". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

device_name

Der Name des Geräts, mit dem das Medium aufgenommen wurde, z. B. "iPhone 3GS".

device_vendor

Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, z. B. "Apple". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

device_software

Die Softwareversion des Geräts, mit dem das Medium aufgenommen wurde, z. B. "3.1.2".

latitude

Der Breitengrad, an dem das Medium aufgenommen wurde, z. B. 52.5374.

longitude

Der Längengrad, an dem das Medium aufgenommen wurde, z. B. 13.4034.

thumb_index

Der bei 0 beginnende Index des aktuellen Thumbnails. Dieser Schlüssel ist nur bei Ergebnissen von 🤖/video/thumbs vorhanden.

thumb_offset

Der Versatz des aktuellen Thumbnails in Sekunden. Dieser Schlüssel ist nur bei Ergebnissen von 🤖/video/thumbs vorhanden.

frame_count

Die Anzahl der Frames in einer animierten GIF-Datei. Bei allen anderen Bildtypen ist dies standardmäßig 1.

colorspace

Der erkannte Farbraum des Mediums, z. B. "sRGB" oder "Gray". Der Farbraum von Videos ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür ist output_meta.colorspace: true nicht erforderlich. Wenn Sie output_meta: false setzen, wird die Metadatenextraktion deaktiviert.

has_clipping_path

Ist true, wenn das Bild einen Beschneidungspfad enthält, andernfalls false.

average_color

Nicht zu verwechseln mit der dominanten Farbe, die die einzelne am häufigsten vorkommende Pixelfarbe zählt und nur begrenzte Anwendungsfälle hat. Die Durchschnittsfarbe wird berechnet, indem das Eingabebild zunächst auf 1 Pixel skaliert wird.

has_transparency

Ob das Bild transparente Bereiche hat. Setzen Sie output_meta.has_transparency auf true, um eine Transparenzprüfung anzufordern. Bereits feststehende false-Werte, etwa false bei JPEG-Bildern, können auch dann zurückgegeben werden, wenn diese Option weggelassen wird oder false ist. Wenn Sie output_meta selbst auf false setzen, wird die zusätzliche Metadatenextraktion übersprungen; grundlegende Prüfungen von Dateityp und Dateigröße können trotzdem laufen.

dominant_colors

Gibt ein Array mit bis zu 10 dominanten Bildfarben als Hexadezimalwerte zurück. Lassen Sie output_meta.dominant_colors weg, um diese Extraktion zu überspringen. Wird die Eigenschaft angegeben, auch mit false, wird die Extraktion angefordert, und es können zusätzliche Nutzungsgebühren anfallen, wenn Farben zurückgegeben werden. Wenn Sie zusätzlich output_meta.dominant_colors_sampled auf true setzen, werden schnellere, angenäherte Farben angefordert, ohne das Ausgabebild zu verändern oder eine weitere Metadatengebühr zu verursachen. Die gesampelte Palette kann abweichen, und die Sampling-Methode kann sich ändern. Wenn Sie output_meta selbst auf false setzen, wird die zusätzliche Metadatenextraktion deaktiviert; grundlegende Prüfungen von Dateityp und Dateigröße können trotzdem laufen.

Videometadaten

Obwohl es von der jeweiligen Datei abhängt, können Dateien, deren type video ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:

width

Die Breite des Mediums in Pixeln. Bei Videos, deren Anzeigeseitenverhältnis von ihrem Pixelseitenverhältnis abweicht, ist dies die vorgesehene Anzeigebreite.

height

Die Höhe des Mediums in Pixeln.

framerate

Die Bildrate des Videos, z. B. 29.5.

video_bitrate

Die Videobitrate des Videos, z. B. 500000.

video_codec

Der Videocodec des Videos, z. B. "ffh264".

audio_bitrate

Die Audiobitrate in Bit pro Sekunde über alle Kanäle, z. B. 128000.

audio_samplerate

Die Audio-Abtastrate in Hertz, z. B. 44100.

audio_channels

Die Anzahl der Audiokanäle, typischerweise 2 für Stereo.

audio_codec

Der Audiocodec, z. B. "faad". Siehe die unterstützten Audiocodecs.

seekable

Ob das Format des Videos das Springen an beliebige Positionen (Seeking) unterstützt, z. B. true.

interlaced

Ob das Video offenbar das Zeilensprungverfahren (Interlacing) verwendet: true für Interlaced-Videos oder false für progressive Videos. Setzen Sie output_meta.interlaced auf true, um die Erkennung anzufordern. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn keine Erkennung angefordert wurde oder die angeforderte Erkennung kein eindeutiges Ergebnis lieferte. Allein das Vorhandensein des Felds zeigt nicht, dass die Erkennung ausgeführt wurde.

field_order

Die von FFprobe gemeldete Halbbildreihenfolge, z. B. "tt", "bb", "tb", "bt" oder "progressive". Setzen Sie output_meta.interlaced auf true, um die Erkennung anzufordern, die dieses Diagnosefeld befüllt. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn keine Erkennung angefordert wurde oder die Halbbildreihenfolge nicht verfügbar war. Verwenden Sie interlaced für eine einfache Unterscheidung zwischen interlaced und progressiv.

interlace_detection

Diagnosedetails aus dem Interlace-Detektor von Transloadit. Dieses Objekt kann sampled_frames, tff, bff, progressive, undetermined, confidence, method und ffprobe_field_order enthalten. Setzen Sie output_meta.interlaced auf true, um die Erkennung anzufordern. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn keine Erkennung angefordert wurde; prüfen Sie auf ein Objekt ungleich null, bevor Sie dessen Eigenschaften lesen.

colorspace

Der erkannte Farbraum des Mediums, z. B. "sRGB" oder "Gray". Der Farbraum von Videos ist verfügbar, wenn er bei aktivierter Metadatenextraktion erkannt wird; dafür ist output_meta.colorspace: true nicht erforderlich. Wenn Sie output_meta: false setzen, wird die Metadatenextraktion deaktiviert.

date_recorded

Datum und Uhrzeit der Aufnahme des Mediums. Ein einzelner gültiger Zeitstempel als String wird auf YYYY/MM/DD HH:MM:SS normalisiert. Ist eine Zeitzone angegeben, wird er in UTC/GMT umgerechnet und endet auf GMT. Nicht parsebare Zeitstempel-Strings werden zu null. Numerische Zeitstempel und Listen wiederholter Datums-Tags behalten ihre ursprünglichen Werte.

date_file_created

Der von den Medienmetadaten gemeldete Erstellungszeitstempel, sofern verfügbar.

date_file_modified

Der vom Dateisystem oder von eingebetteten Medienmetadaten gemeldete Änderungszeitstempel.

device_name

Der Name des Geräts, mit dem das Medium aufgenommen wurde, z. B. "iPhone 3GS".

device_vendor

Der Hersteller des Geräts, mit dem das Medium aufgenommen wurde, z. B. "Apple". String- und numerische Metadatenwerte bleiben erhalten; prüfen Sie den Typ, bevor Sie String-Methoden verwenden.

device_software

Die Softwareversion des Geräts, mit dem das Medium aufgenommen wurde, z. B. "3.1.2".

latitude

Der Breitengrad, an dem das Medium aufgenommen wurde, z. B. 52.5374.

longitude

Der Längengrad, an dem das Medium aufgenommen wurde, z. B. 13.4034.

Beispielsweise können Sie in einem Import- oder Upload-Step Interlaced-Videos erkennen und nur diese Dateien an einen nachfolgenden Step weiterleiten:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle",
      "output_meta": {
        "interlaced": true
      }
    },
    "only_interlaced": {
      "use": ":original",
      "robot": "/file/filter",
      "accepts": [["${file.meta.interlaced}", "==", "true"]]
    }
  }
}

Audiometadaten

Obwohl es von der jeweiligen Datei abhängt, können Dateien, deren type audio ist, in der Eigenschaft meta typischerweise Daten wie die folgenden enthalten:

duration

Die Länge der Audiodatei in Sekunden.

audio_bitrate

Die Audiobitrate in Bit pro Sekunde über alle Kanäle, z. B. 128000.

audio_samplerate

Die Audio-Abtastrate in Hertz, z. B. 44100.

audio_channels

Die Anzahl der Audiokanäle, typischerweise 2 für Stereo.

audio_codec

Der Audiocodec, z. B. "faad". Siehe die unterstützten Audiocodecs.

artist

In den Medienmetadaten erfasste Künstlerangaben. Wiederholte Tags werden als Liste zurückgegeben. Numerisch aussehende Namen sowie die Wörter true und false können als JSON-Zahlen bzw. boolesche Werte ankommen, auch innerhalb von Listen. Prüfen Sie den Typ, bevor Sie String-Methoden verwenden oder über eine Liste iterieren.

mean_volume

Die mittlere Lautstärke der Audiodatei. Setzen Sie output_meta.mean_volume auf true, um die Messung anzufordern. Dieser Schlüssel kann mit dem Wert null vorhanden sein, wenn keine Messung angefordert wurde oder der Wert nicht verfügbar war. Allein das Vorhandensein des Felds zeigt nicht, dass die Messung ausgeführt wurde.

Metadaten von Office-Dokumenten

Dateien, deren type office ist, können diese Felder in meta enthalten, sofern sie in den gespeicherten Eigenschaften der Datei vorhanden sind. Diese Zählwerte werden von der Anwendung gemeldet, mit der das Dokument erstellt wurde; Transloadit berechnet sie nicht anhand des Inhalts neu, daher können sie fehlen oder veraltet sein.

page_count

Die Anzahl der Seiten. Bei Office-Dokumenten stammt sie aus den gespeicherten Eigenschaften der Datei.

word_count

Die in den Eigenschaften eines Office-Dokuments gespeicherte Wortanzahl.

character_count

Die in den Eigenschaften eines Office-Dokuments gespeicherte Zeichenanzahl.

Vorherige Seite ← WebhooksNächste Seite API-Sicherheit →
Support kontaktieren
TransloaditStatus wird geprüft…

Produkt

  • Dienste
  • Preise
  • Demos EN (English)
  • Werkzeuge
  • Sicherheit
  • Support

Unternehmen

  • Über Transloadit/Presse
  • Blog/Stellen EN (English)
  • Vergleiche/Compliance-Matrix
  • Forschung EN (English)
  • Open Source
  • Lösungen
  • Pioniere des Webs

Dokumentation

  • Erste Schritte
  • Transkodierung
  • Häufige Fragen
  • API-Endpunkte
  • Leitfäden/Tipps für Entwickler
  • Unterstützte Formate

Mehr

  • Plattformstatus⁠
  • Community-Forum⁠
  • Uppy
  • tus⁠

© 2009–2026 Transloadit-II GmbH

Transloadit®, tus® und Uppy® sind in den Vereinigten Staaten eingetragene Marken von Transloadit-II GmbH.

Datenschutz EN (English)Nutzungsbedingungen EN (English)Impressum EN (English)Marken EN (English)DMCA-Richtlinie EN (English)
EnglishDeutschEspañolFrançaisPortuguês (Brasil)日本語