ForHosting KIT · Video

Timecode in Framenummer umrechnen

Q: Was geschieht, wenn die Frameziffer größer als die Framerate ist?

FF muss 0 ≤ FF < framerate erfüllen; zum Beispiel ist 00:00:01:30 bei 24 fps illegal. Ungültige Eingabe wird nicht abgerechnet.

Q: Ist das Drop-Frame oder Non-Drop?

Nur Non-Drop. Semikolons in der Eingabezeichenkette gelten als Trennzeichen, aber es werden keine NTSC-Drop-Frame-Sprungtabellen angewendet. Nutzen Sie die ganzzahlige fps Ihres Projekts.

Q: Wie viele Bilder hat eine Minute bei 30 Bildern pro Sekunde?

Eine Minute sind 1800 Bilder. Gezählt wird ab 00:00:00:00 als Bild null, daher ist 00:00:01:00 Bild 30 und 00:01:00:00 bei dieser Rate Bild 1800.

Q: Welche Bildraten kann ich verwenden?

Jede ganze Zahl von 1 bis 240 Bildern pro Sekunde, etwa 24, 25, 30, 48, 50 oder 60. Wählen Sie die Rate Ihres Projekts und verwenden Sie dieselbe in jedem Werkzeug, das dieses Material liest.

Q: Wie wandle ich eine Bildzahl zurück in Timecode um?

Wählen Sie die umgekehrte Richtung und geben Sie die Gesamtzahl der Bilder mit der Projektrate ein. Aus 1800 Bildern bei 30 pro Sekunde wird 00:01:00:00, bereits mit führenden Nullen.

Wandeln Sie Timecode in eine Bildnummer um und zurück: 00:01:00:00 bei 30 Bildern pro Sekunde ist Bild 1800, gezählt ab null, damit Schnitte, Marker und Untertitel genau an der richtigen Stelle sitzen. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

Richtung: To frames
Bildrate: 30
Timecode: 00:01:00:00

Erhalten Sie

Frames: 1.800
Stunden: 0
Minuten: 1
Sekunden: 0

Editoren, Coloristen, QC-Operatoren und Pipeline-Ingenieure wechseln ständig zwischen lesbarem SMPTE-artigem Timecode und den ganzzahligen Framezählern, die NLEs, Renderfarmen und Untertitel-Tools tatsächlich indexieren. Ein einzelner Off-by-one-Fehler in der Frameziffer oder ein Framerate-Mismatch kann einen Schnitt auf den falschen Frame legen, ein EDL zerreißen oder eine Einblendung um eine volle Sekunde verschieben. Dieser Konverter nimmt eine Non-Drop-Zeichenkette HH:MM:SS:FF plus eine ganzzahlige Projekt-Framerate entgegen und liefert die Gesamt-Framenummer ab null, oder er nimmt einen Gesamt-Framezähler und baut einen null-aufgefüllten Timecode neu.

Wie Non-Drop-Timecode auf die Gesamt-Framenummer abbildet

Non-Drop-Timecode im SMPTE-Stil kennzeichnet jeden Frame mit Stunden, Minuten, Sekunden und einer Frameziffer innerhalb der aktuellen Sekunde. Bei konstanter ganzzahliger Framerate fps liefert jede volle Sekunde genau fps Frames, jede Minute sechzig Sekunden und jede Stunde dreitausendsechshundert Sekunden. Die Umrechnung multipliziert daher den Uhranteil der Kennzeichnung mit fps und addiert die Frameziffer: frames ist gleich ((Stunden mal dreitausendsechshundert plus Minuten mal sechzig plus Sekunden) mal fps) plus FF.

Die nullbasierte Zählung beginnt bei 00:00:00:00 als Frame null, sodass 00:00:01:00 bei dreißig Frames pro Sekunde Frame dreißig ist und 00:01:00:00 bei dreißig fps Frame eintausendachthundert. Der Rückweg zerlegt mit ganzzahliger Division und Rest: FF ist frames modulo fps; die verbleibenden ganzen Sekunden werden danach mit der üblichen Sechziger-Uhr in Stunden, Minuten und Sekunden aufgeteilt. Dieser Endpunkt implementiert ausschließlich diese Non-Drop-Arithmetik; er wendet keine NTSC-Drop-Frame-Sprungregeln für neunundzwanzig Komma neun sieben an, weil diese Regeln die Kennzeichnung ändern, ohne die zugrunde liegende Framezählformel in gleicher Weise zu verändern.

Wählen Sie die ganzzahlige fps, die zu Ihrem Projekt passt (vierundzwanzig, fünfundzwanzig, dreißig, achtundvierzig, fünfzig, sechzig und ähnliche), und halten Sie die Kennzeichnungen über alle Tools hinweg konsistent, die dasselbe Material lesen.

Wo bildgenauer Timecode wirklich hilft

Redaktionsassistenten übersetzen oft Cue-Sheets und Produzentennotizen in HH:MM:SS:FF in Framenummern für Marker, während Ingenieure den umgekehrten Weg gehen, wenn sie Renderbereiche für eine Farm protokollieren, die nur Ganzzahlen versteht. Untertitel- und Caption-Pipelines wandeln In- und Out-Punkte um, damit SRT- oder VTT-Cues auf legalen Frames der Liefer-fps landen. QC-Skripte können illegale FF-Werte ablehnen, bevor ein Paket die Facility verlässt, und fangen so einen häufigen Einfügefehler ab, der einen rein textuellen Validator passieren würde.

LMS und Filmhochschul-Labore nutzen den kostenlosen Browserpfad, damit Studierende Non-Drop-Arithmetik üben, ohne Desktop-Rechner zu installieren, die bei nullbasierter Zählung abweichen.

Anwendungsfälle

Redaktionelle Cue-Sheets zu Frame-Markern

Wandeln Sie Produzentennotizen in HH:MM:SS:FF in Gesamt-Framenummern für Marker, Bereiche und Renderjobs bei der angegebenen Projekt-fps um.

Untertitel- und QC-Validierung

Lehnen Sie illegale Frameziffern (FF ≥ fps) vor dem Packaging ab und bauen Sie aufgefüllten Timecode aus ganzzahligen In-/Out-Punkten der Exportwerkzeuge neu.

Häufige Fragen

Wie wandle ich einen Framezähler zurück in Timecode um?

Die Antwort baut null-aufgefülltes HH:MM:SS:FF und die Komponenten Stunde, Minute, Sekunde und Frame neu.

Was geschieht, wenn die Frameziffer größer als die Framerate ist?

FF muss 0 ≤ FF < framerate erfüllen; zum Beispiel ist 00:00:01:30 bei 24 fps illegal. Ungültige Eingabe wird nicht abgerechnet.

Ist das Drop-Frame oder Non-Drop?

Nur Non-Drop. Semikolons in der Eingabezeichenkette gelten als Trennzeichen, aber es werden keine NTSC-Drop-Frame-Sprungtabellen angewendet. Nutzen Sie die ganzzahlige fps Ihres Projekts.

Wie viele Bilder hat eine Minute bei 30 Bildern pro Sekunde?

Eine Minute sind 1800 Bilder. Gezählt wird ab 00:00:00:00 als Bild null, daher ist 00:00:01:00 Bild 30 und 00:01:00:00 bei dieser Rate Bild 1800.

Welche Bildraten kann ich verwenden?

Jede ganze Zahl von 1 bis 240 Bildern pro Sekunde, etwa 24, 25, 30, 48, 50 oder 60. Wählen Sie die Rate Ihres Projekts und verwenden Sie dieselbe in jedem Werkzeug, das dieses Material liest.

Wie wandle ich eine Bildzahl zurück in Timecode um?

Wählen Sie die umgekehrte Richtung und geben Sie die Gesamtzahl der Bilder mit der Projektrate ein. Aus 1800 Bildern bei 30 pro Sekunde wird 00:01:00:00, bereits mit führenden Nullen.

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/video/timecode-convert-frames

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/video/timecode-convert-frames \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction":"to_frames","framerate":30,"timecode":"00:01:00:00"}'

const res = await fetch("https://api.kit.forhosting.com/video/timecode-convert-frames", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "direction": "to_frames",
    "framerate": 30,
    "timecode": "00:01:00:00"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/timecode-convert-frames",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "direction": "to_frames",
    "framerate": 30,
    "timecode": "00:01:00:00"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/timecode-convert-frames", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"direction":"to_frames","framerate":30,"timecode":"00:01:00:00"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"direction":"to_frames","framerate":30,"timecode":"00:01:00:00"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/timecode-convert-frames", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "direction": "to_frames",
  "framerate": 30,
  "timecode": "00:01:00:00"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.timecode_convert_frames",
  "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.002

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

Limits

`max_mb`	500
`max_minutes`	60
`max_megapixels`	3.9

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.

Technische Hinweise

Wenn die Frameziffer FF größer oder gleich der Framerate ist, schlägt die Anfrage mit invalid_input fehl, statt den Wert still zu umbrechen.

Eingabevertrag, Validierungsregeln und Antwortfelder

Die Framerate muss eine Ganzzahl von eins bis zweihundertvierzig Frames pro Sekunde sein. Stunden dürfen von null bis neuntausendneunhundertneunundneunzig laufen; Minuten und Sekunden müssen zwischen null und neunundfünfzig liegen. Die kritische redaktionelle Regel gilt für die Frameziffer: FF muss null kleiner oder gleich FF und FF strikt kleiner als framerate erfüllen. Der Umkehrweg mit frames eintausendachthundert und derselben fps baut 00:01:00:00 neu. Senden Sie per POST einen JSON-Body mit direction, framerate und entweder timecode oder frames. Die Richtung to_frames (Aliasse frames, tc_to_frames) erfordert eine Timecode-Zeichenkette HH:MM:SS:FF; Doppelpunkte oder Semikolons sind als Trennzeichen erlaubt, die Mathematik ist jedoch stets Non-Drop. Die Richtung to_timecode (Aliasse timecode, frames_to_tc) erfordert ein nichtnegatives ganzzahliges Feld frames. Bei Erfolg spiegelt der Body direction und framerate wider, liefert einen normalisierten null-aufgefüllten Timecode-String, die Gesamt-frames-Ganzzahl, die zerlegten Komponenten Stunden, Minuten, Sekunden und Frame sowie einen kurzen Formelstring, der die Non-Drop-Identität bekräftigt. Beispiel: direction to_frames, framerate dreißig, timecode 00:01:00:00 ergibt frames eintausendachthundert.

Wo eine framegenaue Timecode-API ihren Nutzen zeigt

Weil die Implementierung pure parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Basispreis $0.002 ohne Modell-Token und ohne ausgehendes Netz; fehlgeschlagene Validierung wird nicht abgerechnet.

Integrationsbeispiele

Unterricht und Pipeline-Unit-Tests

Geben Sie Studierenden und CI-Jobs ein deterministisches Non-Drop-Orakel, das Frame null bei 00:00:00:00 in Browser und API übereinstimmend liefert.

Technische Fragen

Wie wandle ich HH:MM:SS:FF in eine Gesamt-Framenummer um?

Senden Sie direction to_frames, eine ganzzahlige Framerate (fps) und einen Timecode wie 00:01:00:00. Die API liefert frames = ((H×3600+M×60+S)×fps)+FF mit normalisiertem, aufgefülltem Timecode.

Was kostet der Konverter von Timecode zu Framenummer?

Das Browser-Tool ist kostenlos. API-Anfragen nutzen das Prepaid-KIT-Guthaben zu $0.002 pro erfolgreichem Aufruf; ungültige Eingabe wird nicht abgerechnet.

Vollständige KIT-Dokumentation lesen →