UtteraUttera

Wie Sie um Hilfe bitten

Auf einen Blick. Wie man Hilfe anfordert und was man angeben sollte (Schlüssel, Uhrzeit, X-Request-Id), damit wir schnell antworten.

Eine Adresse und das war's: support@uttera.ai. Ein Mensch antwortet.

Es gibt kein Formular, keine Ticketnummer und keinen Bot, der fragt, ob Sie es mit einem Neustart versucht haben. Wenn das Volumen es verlangt, bauen wir etwas mit mehr Maschinerie, und das wird hier gesagt; bis dahin kommt eine E-Mail schneller an und wird ebenso beantwortet.

Wenn Sie wissen wollen, ob der Dienst ausgefallen ist, statt ob es nur bei Ihnen klemmt, prüft man das vor dem Schreiben: Dienststatus.

Was Sie uns schicken sollen

Das reicht fast immer, um herauszufinden, was passiert ist, ohne Sie um irgendetwas anderes bitten zu müssen:

AngabeWoher sie kommt
X-Request-Id – die wichtigsteEin Header auf der fehlgeschlagenen Antwort. Er identifiziert Ihre genaue Anfrage unter allen des Tages.
Ungefähre Uhrzeit und ZeitzoneIhre Uhr. Ohne die Zone ist eine Uhrzeit völlig nutzlos.
Der Endpunkt/v1/audio/transcriptions, /v1/summarize…
Was Sie erwartet haben und was passiert istSie. Der wörtliche Fehler, falls es einen gibt, lieber eingefügt als zusammengefasst.
Ihre KundenkennungSie steht auf Ihrer Kontoseite. Sie ist kein Zugangsdatum: Sie zu kennen gewährt keinerlei Zugriff.
Schicken Sie uns niemals Ihren API-Schlüssel. Nicht das Ganze, und auch nicht „die ersten paar Zeichen für alle Fälle". Wir brauchen ihn für nichts: Mit der X-Request-Id finden wir die Anfrage. Sollten wir je einen Schlüssel in einer E-Mail erhalten, widerrufen wir ihn und sagen es Ihnen.

Und wenn das Problem eine bestimmte Audiodatei betrifft, müssen Sie sie nicht senden, um anzufangen. Fast alles wird aus der Anfragekennung diagnostiziert. Sollten wir je das Audio brauchen, fragen wir danach und erklären wofür – was der einzige Weg ist, wie eine Aufnahme von Ihnen länger in unsere Hände geraten kann als die Sekunden, die ihre Verarbeitung dauert.

Wie lange wir brauchen

Dazu verpflichten wir uns. Es ist die Zeit bis zur ersten Antwort an Werktagen, nicht die Zeit bis zur Lösung: Manche Störungen sind in zehn Minuten behoben und andere nicht, aber zu wissen, dass jemand sich das ansieht, sollte nicht vom Zufall abhängen.

TarifErste Antwort
FreeSo schnell wir können. Keine Zusage – aber es wird gelesen.
Startup · Developer2 Werktage
Professional1 Werktag
Business4 Geschäftsstunden
EnterpriseDirekter Kontakt, im Vertrag vereinbart
Das ist nicht das SLA. Das SLA Ihres Tarifs ist eine Zusage über die Dienstverfügbarkeit und steht für sich. Eine spät beantwortete E-Mail verbraucht kein SLA, und ein ausgefallener Dienst wird nicht dadurch behoben, dass man eine E-Mail schnell beantwortet.

Wenn wirklich etwas kaputt ist

Wenn Sie glauben, einen Fehler von uns gefunden zu haben – keine Nutzungsfrage – sagen Sie es im Betreff. Wir kümmern uns vor allem anderen darum, und wenn sich herausstellt, dass Sie recht hatten, veröffentlichen wir es: in dieser Dokumentation, wenn es etwas Hier-Geschriebenes ändert, und im Changelog, wenn es den Dienst betrifft.

Und wenn das, was Sie gefunden haben, ein Sicherheitsproblem ist, schreiben Sie es an dieselbe Adresse mit [seguridad] im Betreff und veröffentlichen Sie es in der Zwischenzeit nicht. Wir antworten mit dem, was wir wissen, und mit einem Zeitrahmen.

Häufige Fragen

Auf einen Blick. Häufige Fragen und Fehler. Für genaue Preise, Limits und Sprachen verweisen wir auf ihre jeweilige Seite, damit hier nichts veraltet.

Erste Schritte und Konto

Wie bekomme ich einen API-Schlüssel? Registrieren Sie sich auf app.uttera.ai und erzeugen Sie ihn in Ihrem Konto. Er reist im Header Authorization: Bearer sk-....

Kann ich mehrere Schlüssel haben? Ja. Erstellen Sie einen pro Integration (Web, Mobil, ein Konnektor…), um einen widerrufen zu können, ohne die anderen anzurühren.

Wie widerrufe oder tausche ich einen Schlüssel? In Ihrem Konto: den alten löschen und einen neuen erstellen. Der Widerruf ist sofort wirksam.

Gibt es einen kostenlosen Tarif? Ja, mit einem monatlichen Kontingent zum Ausprobieren. Was jeder Tarif enthält, steht unter Tarife.

Wie wechsle ich den Tarif? In Ihrem Konto. Beim Hochstufen wird die anteilige Differenz berechnet und der neue Tarif gilt sofort.

Gibt es Jahrestarife? Ja, mit Rabatt gegenüber dem Monat. Siehe Tarife.

Wie sehe ich meinen Verbrauch? Ihr Konto zeigt Verbrauch, Restguthaben und einen Anfragenverlauf.

Was passiert, wenn mein Guthaben aufgebraucht ist? Sie erhalten Hinweise bei 80 % und 100 %. Danach geben kostenpflichtige Anfragen 402 zurück, bis Sie aufladen oder hochstufen.

Kann ich Guthaben kaufen, ohne den Tarif zu wechseln? Ja, es gibt Guthabenpakete, die zu Ihrem Kontingent hinzukommen.

Wie bezahle ich? Per Karte und auch mit Kryptowährung (Bitcoin). Die Rechnung enthält Ihre USt-IdNr., wenn Sie sie im Konto hinterlegen.

Fehler und Codes

401 — nicht autorisiert. Der Schlüssel fehlt oder ist falsch. Prüfen Sie, dass Sie Authorization: Bearer <Ihr-Schlüssel> senden und der Schlüssel noch aktiv ist.

403 — verboten. Ihr Tarif enthält diese Aktion nicht. Sehen Sie unter Tarife, was jeder Tarif enthält, und stufen Sie bei Bedarf hoch.

413 — zu groß. Das Audio oder der Text überschreitet das Limit dieser Aktion. Verkleinern oder kürzen Sie die Datei oder nutzen Sie den asynchronen Modus. Die Limits stehen in Referenz.

402 — unzureichendes Guthaben. Ihr Monatsguthaben ist aufgebraucht. Kaufen Sie ein Guthabenpaket oder stufen Sie hoch.

429 — zu viele Anfragen. Sie senden zu schnell. Versuchen Sie es mit wachsender Wartezeit (Backoff) zwischen den Aufrufen erneut.

500 / 503 — Serverfehler. Meist vorübergehend. Erneut versuchen; bleibt es bestehen, schreiben Sie uns mit der X-Request-Id.

504 bei einer langen Zusammenfassung. Der synchrone Modus von /v1/summarize bricht bei 10 Minuten ab und berechnet nichts. Für langes Audio nutzen Sie den asynchronen Modus, ohne dieses Limit.

Was ist die X-Request-Id? Ein Antwort-Header, der Ihre genaue Anfrage identifiziert. Senden Sie ihn uns bei einer Anfrage, und wir finden heraus, was passiert ist, ohne etwas anderes zu brauchen.

Transkription

Welche Audioformate akzeptieren Sie? wav, mp3, m4a, ogg, opus, flac, webm, aac und amr.

Gibt es eine maximale Audiogröße? Ja, und im synchronen Modus gibt es ein Dauerlimit. Für große oder lange Dateien nutzen Sie den asynchronen Modus. Details in Referenz.

Welche Sprachen transkribieren Sie? Viele; die Liste je Aktion steht in Referenz. Scheitert die Erkennung, geben Sie die Sprache explizit an.

Meine Transkription kam leer oder fehlerhaft zurück. Meist Audio ohne Stimme/Stille, falsch erkannte Sprache (setzen Sie language) oder eine beschädigte Datei. Prüfen Sie das Audio und versuchen Sie es erneut.

Sagt es mir, wer wann spricht? Ja, mit der Diarisierung: Sie gibt Segmente mit Sprecher und Zeitstempel zurück.

Ist es mit der OpenAI-API kompatibel? Ja. Richten Sie Ihr OpenAI-SDK auf unseren Endpunkt und nutzen Sie dieselben Namen (z. B. whisper-1). Siehe Integration.

Stimme und Klonen

Welche Stimmen und Sprachen gibt es? Ein Katalog von Stimmen je Sprache; die Liste steht in Studio.

Kann ich eine Stimme klonen? Ja: Sie geben eine kurze Stimmprobe und den zu sprechenden Text. Es gibt ein Zeichenlimit pro Anfrage (siehe Referenz).

Brauche ich eine Erlaubnis, um eine Stimme zu klonen? Ja. Eine Stimme ist ein biometrisches Datum: Klonen Sie nur Ihre eigene Stimme oder eine mit ausdrücklicher Einwilligung. Eine dritte Person zur Nachahmung zu klonen ist illegal.

Trägt das erzeugte Audio ein Wasserzeichen? Ja, ein unhörbares Wasserzeichen, das die KI-Verordnung der EU vorschreibt (Art. 50.2). Es lässt sich nicht deaktivieren.

Übersetzung

Übersetzen Sie Text und Stimme? Beides: in Text oder übersetzt und gesprochen.

Kann ich beim Übersetzen meine Stimme behalten? Ja: Beim Übersetzen von Stimme können Sie die Originalstimme des Sprechers statt einer aus dem Katalog behalten.

Welche Übersetzungssprachen gibt es? In Referenz. Einige Codes haben Besonderheiten (z. B. Norwegisch oder Chinesisch); die Doku weist darauf hin.

Zusammenfassung und verifizierbarer Bericht

Können Sie eine Aufnahme zusammenfassen? Ja: Sie transkribiert und gibt eine strukturierte Zusammenfassung zurück (Kernpunkte, Daten, Aufgaben, wer gesprochen hat).

Was ist der verifizierbare Bericht? Ein signiertes PDF mit einem Beweisgraphen, den jeder prüfen kann: Es verknüpft jede Aussage mit dem Moment im Audio. Siehe Verifizierbarer Bericht.

Wie prüfe ich einen Bericht? Mit der Prüf-Aktion: Sie kontrolliert die Signatur (Ed25519) und dass das PDF nicht verändert wurde.

Klänge und Musik

Erzeugen Sie Soundeffekte? Ja, aus einer Beschreibung (eine Tür, Regen, Schritte) und auch Klangszenen mit mehreren gemischten Ereignissen.

Und Musik? Ja, ein Stück aus einer Beschreibung. Die Kosten hängen von Länge × Qualitätsschritten ab; stellen Sie beides ein.

Welche Lizenz hat erzeugte Musik? Für Ihre Nutzung gemäß den Bedingungen; Details in der Doku Klänge und Musik. Sie trägt das Wasserzeichen nach Art. 50.2.

Aussprache

Analysieren Sie die Aussprache? Ja: Sie vergleichen eine Aufnahme mit einem Referenzsatz und erhalten Genauigkeit, erwartete vs. gehörte Phoneme und gruppierte Fehler. Siehe Aussprechen.

Datenschutz, Recht und Daten

Trainieren Sie mit meinen Daten? Nein. Ihr Audio und Ihr Text werden nicht zum Training genutzt und nicht wiederverwendet. Siehe Datenschutz.

Wo werden meine Daten verarbeitet? In der EU, auf eigener Infrastruktur. Siehe Datenschutz und Nachhaltigkeit.

Wie lange bewahren Sie das Audio auf? Bei asynchronen Aufträgen wird das Material pro Auftrag verschlüsselt und nach kurzer Zeit automatisch gelöscht. Details in Datenschutz.

Haben Sie DSGVO / einen Auftragsverarbeitungsvertrag (AVV)? Ja. Siehe Rechtsrahmen.

Kann ich die Löschung meiner Daten verlangen? Ja, schreiben Sie uns. Siehe Rechtsrahmen.

Integrationen und Konnektoren

Funktioniert es mit dem OpenAI-SDK? Ja: Ändern Sie die base_url auf unseren Endpunkt und nutzen Sie Ihren Code weiter. Siehe Integration.

Haben Sie einen Konnektor für Claude / ChatGPT / Gemini? Ja, eine Skill, die das Audio aus der Sandbox des Modells hochlädt, ohne dass das Audio durch das LLM läuft. Siehe Konnektoren.

Und einen MCP-Server? Ja (Audio nur per öffentlicher URL). Für lokale Dateien nutzen Sie die Skill. Siehe Konnektoren.

Slack und Telegram? Ja, es gibt Bots, die das gesendete Audio transkribieren. Siehe Konnektoren.

n8n? Ja, es gibt Uttera-Nodes für n8n.

Haben Sie Apps, um es ohne Programmieren zu nutzen? Ja, installierbare Web-Apps: Zusammenfassung, Dolmetscher (Stimme↔Stimme) und Aussprache-Coach.

Die Skill meldet einen Netzwerkfehler in Claude. Bei Team/Enterprise-Konten muss ein Administrator api.uttera.ai in der Netzwerk-Allowlist der Organisation freigeben. Bei Einzeltarifen ist das nicht nötig. Siehe Konnektoren.

Asynchron und Webhooks

Kann ich lange Aufträge senden, ohne zu warten? Ja: Der asynchrone Modus stellt den Auftrag in die Warteschlange und benachrichtigt Sie per Webhook, wenn er fertig ist, ohne das synchrone 10-Minuten-Limit.

Sind Webhooks signiert? Ja, mit HMAC, damit Sie prüfen können, dass sie von uns kommen.