Tarife und Limits | transcript1 docs

Du zahlst bei transcript1 nach der Länge deiner Aufnahme. Dein Tarif legt fest, wie viele Minuten du hast, wie viele Requests du senden und wie viele Transkriptionen du gleichzeitig starten kannst.

Tarife

	Free	Monthly	Annual
Preis	$0, ohne Karte	$9 / Monat	$90 / Jahr
Minuten	60, einmalig	1.000 / Monat	1.000 / Monat
Aufladungen	Nicht verfügbar	$6 pro 1.000 Minuten	$5 pro 1.000 Minuten
Requests pro Minute	30	200	300
Gleichzeitige Jobs	2	10	20

Unter „Billing“ im Dashboard wechselst du deinen Tarif oder kaufst zusätzliche Minuten.

So rechnen wir ab

Pro angefangener Minute verbrauchst du 1 Credit. Für ein Video mit 61 Sekunden sind das 2 Minuten. Die Mindestabrechnung liegt bei 1 Minute.
Der Minutenpreis ist für alle Quellen gleich: YouTube, X, TikTok, Instagram, Facebook, Bluesky, die weiteren unterstützten Plattformen und eigene Dateien. Bei Plattform-Untertiteln zählt die gemessene Videodauer, bei Speech-to-Text die gemessene Audiodauer. Für YouTube- und X-Untertitel gelten dabei dieselben Regeln wie für TikTok und Bluesky.
Wenn du dasselbe Video noch einmal transkribierst, zahlst du erneut. Mit reuse_recent=true kannst du stattdessen dein eigenes, kürzlich erstelltes Transkript abrufen, ohne noch einmal Minuten zu verbrauchen. Mehr dazu in der API-Referenz.
Wenn eine Transkription fehlschlägt oder du sie abbrichst, zahlst du nichts. Bereits abgezogene Minuten schreiben wir dir wieder gut.

Kostenlose Minuten

Zum Start bekommst du einmalig 60 kostenlose Minuten. Bestätige dafür deine E-Mail-Adresse. Bei der Registrierung mit Google oder Microsoft sind die Minuten sofort verfügbar. Im Tarif Free kommen keine weiteren Minuten dazu. Ohne bestätigte E-Mail-Adresse antwortet POST /v1/transcriptions mit 403 email_not_verified.

Tarifminuten und Aufladungen

Dein Minutenguthaben setzt sich so zusammen:

Tarifminuten sind die Minuten, die dein Tarif enthält. Zu Beginn des nächsten Abrechnungszeitraums setzt sich dieses Kontingent zurück. Was du nicht verbraucht hast, verfällt. Monthly und Annual enthalten jeweils 1.000 Minuten pro Monat.
Aufladungen sind zusätzlich gekaufte Minuten. Ein Paket enthält 1.000 Minuten; pro Kauf sind 1 bis 20 Pakete möglich. Dafür brauchst du einen kostenpflichtigen Tarif. Zuerst verbrauchst du deine Tarifminuten, danach die Aufladungen. Solange dein kostenpflichtiger Tarif aktiv ist, verfallen die zusätzlich gekauften Minuten nicht.

Nach der Kündigung eines kostenpflichtigen Tarifs wechselst du zurück zu Free, ohne verbleibende Tarifminuten. Deine Aufladungen bleiben gespeichert. Nutzen kannst du sie wieder, sobald du einen kostenpflichtigen Tarif aktivierst. Beim Wechsel von Free zu einem kostenpflichtigen Tarif übernehmen wir deine übrigen kostenlosen Minuten als Aufladung.

Guthaben abfragen

Mit GET /v1/account fragst du dein Guthaben ab. Der Aufruf kostet keine Minuten:

curl https://api.transcript1.com/v1/account \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"

Feld	Bedeutung
`minutes.remaining`	Aktuell nutzbare Minuten: `cycle` plus `topup`, sofern `topup_usable` auf `true` steht.
`minutes.cycle`	Übrige Minuten aus deinem Tarif.
`minutes.topup`	Guthaben aus Aufladungen.
`minutes.topup_usable`	Steht bei einem aktiven kostenpflichtigen Tarif auf `true`.
`minutes.resets_at`	Zeitpunkt der nächsten Erneuerung des Tarifkontingents oder `null`.
`limits`	Enthält deine Werte für `requests_per_minute` und `max_active_jobs`.

Außerdem bekommst du die Felder plan und renews_at zurück.

Sind keine Minuten mehr verfügbar, antwortet POST /v1/transcriptions mit 402 insufficient_minutes. Über die mitgelieferte action_url kommst du zur Seite „Billing“. Bei einem Guthaben von 0 Minuten schicken wir dir außerdem eine E-Mail, höchstens einmal pro Abrechnungszeitraum.

Rate Limits

Alle API-Schlüssel, Dashboard-Sitzungen und MCP-Verbindungen eines Kontos teilen sich dieselben Limits.

Requests pro Minute: 30 mit Free, 200 mit Monthly und 300 mit Annual. Gezählt wird in Zeitfenstern von jeweils einer Minute.
Jede Antwort auf einen authentifizierten /v1-Request enthält X-RateLimit-Limit für dein Limit und X-RateLimit-Remaining für die übrigen Requests im aktuellen Zeitfenster.
Wenn du das Limit überschreitest, bekommst du 429 rate_limited. Im Header Retry-After steht, wie viele Sekunden es bis zum nächsten Zeitfenster dauert.
Chunks sendest du mit dem Upload-Token. Diese Uploads zählen nicht zum Request-Limit.

Wie viele Jobs dürfen gleichzeitig laufen?

Jobs mit dem Status queued, fetching oder transcribing zählen als aktiv. Mit Free dürfen 2 gleichzeitig laufen, mit Monthly 10 und mit Annual 20. Ist kein Platz mehr frei, antwortet die API mit 429 too_many_active_jobs und einem Retry-After-Header. Warte, bis ein Job fertig ist, und starte dann den nächsten.

Ein Upload im Status awaiting_upload zählt noch nicht als aktiver Job. Pro Team dürfen aber höchstens 20 Uploads offen sein. Auch hier bekommst du bei Überschreitung 429 too_many_active_jobs. Sobald du einen Upload abschließt, kommt der Job in die Warteschlange. Deshalb prüft die API beim Abschließen das Limit für aktive Jobs.

Wie du auf die einzelnen Fehler reagierst, steht unter Fehler.