podonos/onepin-python

Was macht onepin-python?

Onepin Python SDK + CLI — Produktionsreife Sprachaudios über 100+ TTS-Modelle orchestrieren, validieren und ausliefern

Überblick

Onepin ist eine umfassende Plattform zur Verwaltung und Auslieferung von Sprachaudios. Mit diesem Skill können Sie:

• Orchestrieren: Mehrere TTS-Modelle parallel ansteuern und Ergebnisse vergleichen
• Validieren: Audioqualität automatisch prüfen (Natürlichkeit, Verständlichkeit, Stimmkonsistenz)
• Ausliefern: Optimierte Audiodateien direkt in Ihre Anwendung oder Pipeline integrieren

Installation

pip install onepin-python

Schnellstart

from onepin import OnepinClient

client = OnepinClient(api_key="DEIN_API_KEY")

# Beispiel: Sprachaudio generieren und validieren
result = client.synthesize(
    text="Hallo Welt, dies ist ein Test.",
    model="elevenlabs-multilingual-v2",
    voice="de-DE-Standard-A"
)

print(f"Audio-ID: {result.audio_id}")
print(f"Qualitäts-Score: {result.quality_score}")

CLI-Nutzung

# Text in Sprache umwandeln
onepin synthesize --text "Hallo Welt" --model "elevenlabs-multilingual-v2"

# Audioqualität validieren
onepin validate --audio-id "abc123"

# Modelle auflisten
onepin list-models

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex
• Jede Python-Umgebung (≥3.8)

API-Referenz

OnepinClient(api_key: str)

Erstellt einen neuen Client.

Parameter:

• api_key (str): Ihr Onepin-API-Schlüssel

client.synthesize(text, model, voice, **kwargs)

Generiert Sprachaudio aus Text.

Parameter:

• text (str): Der zu synthetisierende Text
• model (str): TTS-Modell-ID (z. B. "elevenlabs-multilingual-v2")
• voice (str): Stimmen-ID (z. B. "de-DE-Standard-A")
• **kwargs: Zusätzliche Parameter (Geschwindigkeit, Tonhöhe, etc.)

Rückgabe: SynthesisResult mit audio_id, quality_score, duration, file_path

client.validate(audio_id)

Validiert die Qualität eines generierten Audios.

Parameter:

• audio_id (str): ID des zu validierenden Audios

Rückgabe: ValidationResult mit Metriken (Natürlichkeit, Verständlichkeit, Stimmkonsistenz)

Umgebungsvariablen

• ONEPIN_API_KEY: Ihr API-Schlüssel (alternativ zur Übergabe im Code)

Beispiele

Weitere Beispiele finden Sie im Ordner examples/ dieses Repositorys.

Lizenz

MIT-Lizenz