ForHosting KIT · Audio & Sprache

Metadaten einer Audiodatei auslesen

KIT liest die in einer Audiodatei gespeicherten Metadaten aus – etwa Titel, Interpret, Album und Erscheinungsjahr – oder schreibt neue Angaben hinein. Gedacht für alle, die viele Audiodateien verwalten und dabei einheitliche, korrekte Angaben statt leerer oder falscher Felder brauchen.

● Stabilpro Anfrage + pro Datei$0.077

Ausführen — $0.077 + $0.0045/Datei API ansehen

Nutzen Sie es über WebAPIE-MailApp baldTelegram bald

Online ausführen

Führen Sie dies mit Ihrem Konto auf unseren Servern aus. Kostenlose Tools laufen in Ihrem Browser; dieses wird zum oben genannten Preis von Ihrem KIT-Guthaben abgebucht.

Was in den Metadaten steckt

Eine Audiodatei speichert neben dem eigentlichen Ton meist zusätzliche Angaben wie Titel, Interpret, Album, Erscheinungsjahr und ein Vorschaubild – bekannt als ID3-Tags bei MP3-Dateien. Diese Funktion liest diese Angaben aus einer bestehenden Datei aus oder schreibt neue Werte hinein, ohne den Toninhalt selbst zu verändern. Fehlen diese Angaben, zeigen Player oft nur den Dateinamen an, statt Titel und Interpret sauber auszuweisen.

Aktueller Stand: in Bereitstellung

Diese Funktion befindet sich derzeit in der Bereitstellung und nimmt noch keine Ausführungen entgegen. Geplant ist ein fester Preis pro Datei, unabhängig von deren Länge: $0.077 pro Anfrage plus $0.0045 pro Datei, insgesamt $0.0815. Die Grenze liegt bei 200 MB pro Datei. Diese Zahlen ändern sich beim Start nicht mehr, unabhängig davon, wie viele Felder in der Anfrage gesetzt werden.

Wofür sich Metadaten-Pflege lohnt

Ein Musikarchiv mit tausenden Dateien ohne einheitliche Interpretenangabe; ein Podcast-Feed, in dem jede Episode denselben Titel wie die Audiodatei selbst tragen soll; eine Sammlung von Aufnahmen, die vor der Weitergabe an ein Archiv mit korrekten Angaben versehen werden muss. In allen Fällen ersetzt das automatische Auslesen oder Setzen das manuelle Öffnen jeder einzelnen Datei in einem separaten Programm, Datei für Datei.

Auslesen und Schreiben in einem Schritt

Die Funktion deckt beide Richtungen ab: das reine Auslesen bestehender Angaben für eine Übersicht oder Prüfung, und das Schreiben neuer Werte, um fehlende oder falsche Angaben zu korrigieren. Beides läuft über denselben Preis pro Datei, unabhängig davon, wie viele Felder betroffen sind, sodass sich auch das Korrigieren mehrerer Felder auf einmal nicht zusätzlich verteuert, im Vergleich zum Setzen eines einzelnen Feldes.

Anwendungsfälle

Musikarchiv vereinheitlichen

Ein kleines Label lässt bei tausenden älteren MP3-Dateien die Interpretenangabe auslesen, um Dateien ohne diesen Eintrag automatisch zu erkennen und gezielt nachzupflegen.

Podcast-Episoden korrekt beschriften

Ein Podcast-Team schreibt bei jeder neuen Episode automatisch Titel, Album und Erscheinungsjahr in die Metadaten der Audiodatei, bevor sie in den Feed eingespielt wird.

Archivbestand vor der Übergabe prüfen

Ein Verein liest vor der Übergabe eines Audioarchivs an eine Bibliothek die Metadaten aller Dateien aus, um fehlende Angaben zu erkennen und zu ergänzen.

Häufige Fragen

Liest die Funktion nur Metadaten oder kann sie auch neue schreiben?

Beides ist vorgesehen: das Auslesen bestehender Angaben und das Schreiben neuer oder korrigierter Werte in dieselbe Datei.

Ist diese Funktion schon nutzbar?

Noch nicht, sie befindet sich derzeit in der Bereitstellung und nimmt keine Ausführungen an. Preis und Grenzen sind bereits veröffentlicht.

Wonach richtet sich der Preis: nach der Länge der Datei?

Nein, nach der Datei selbst: $0.0815 pro Datei, unabhängig von deren Länge oder Größe innerhalb der Grenze.

Verändert das Setzen von Metadaten den Toninhalt?

Nein, es werden ausschließlich die zusätzlichen Angaben verändert, der eigentliche Ton bleibt unangetastet.

Welche Felder lassen sich setzen?

Vorgesehen sind die gängigen Felder wie Titel, Interpret, Album, Erscheinungsjahr und Genre.

Was passiert mit meiner Datei nach der Verarbeitung?

Sie wird ausschließlich zur Erstellung des Ergebnisses verwendet und nicht veröffentlicht oder an Dritte weitergegeben.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/audio/metadata

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/audio/metadata \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/audio/metadata", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/audio/metadata",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/audio/metadata", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/audio/metadata", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "input": "…"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "audio.metadata",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.077

pro Datei$0.0045

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

`max_mb`	200
`max_minutes`	180

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →