FishAudio in Coze verwenden

FishAudio bietet zwei Plugins im Coze Plugin Store. Die Installation der Plugins ist der empfohlene Weg; verwende die direkte HTTP-Konfiguration nur für individuelle Anfragen.

API Key vorbereiten

Erstelle auf der API-Verwaltungsseite einen eigenen Key für Coze und prüfe deine API-Credits. Übergib den Key so:

Authorization: Bearer YOUR_FISH_AUDIO_API_KEY

Nach Bearer muss ein Leerzeichen stehen. Jeder Kunde verwendet seinen eigenen Key; die Nutzung wird dem jeweiligen Fish-Audio-Konto belastet.

Privates Plugin selbst erstellen

Wer die Store-Plugins nicht verwenden möchte, kann FishAudio TTS 文字转语音 OpenAPI, FishAudio 图片/视频对口型 OpenAPI, FishAudio 文字对口型 OpenAPI oder FishAudio 专属语音合成 OpenAPI herunterladen und in Coze als Cloud-Plugin aus einem vorhandenen Dienst importieren. Wähle keine Autorisierung und übergib die kundeneigene Authorization zur Laufzeit. Einzelheiten stehen im English guide.

Empfohlen ist Import oben rechts; dort wird nur die OpenAPI-YAML benötigt. Wenn links ai_plugin (JSON) und rechts openapi (YAML) angezeigt werden, befindest du dich auf der </>-Code-Erstellungsseite. ai_plugin darf dann nicht leer bleiben: links die passende *.ai-plugin.json und rechts die *.openapi.yaml mit demselben Präfix einfügen. manifest.json ist nur das FishAudio-Paketverzeichnis und kein ai_plugin.

Aktueller Status: FishAudio TTS 文字转语音 und FishAudio 图片/视频对口型 sind im Store verfügbar; FishAudio 文字对口型 und FishAudio 专属语音合成 werden nur als private Import-Plugins angeboten.

FishAudio TTS 文字转语音 verwenden

1. Füge FishAudio TTS 文字转语音 deinem Coze-Arbeitsbereich hinzu.
2. Füge das TTS-Tool einem Agenten oder Workflow hinzu.
3. Gib Authorization, Text, Voice ID und optionale Einstellungen ein.
4. Verbinde die zurückgegebene audio_url mit Wiedergabe, Download oder Media Sync.

Teste zuerst mit einem kurzen Satz. Die Voice ID muss eine gültige Systemstimme oder eine im aktuellen Konto verfügbare benutzerdefinierte Stimme sein.

FishAudio 图片/视频对口型 verwenden

FishAudio 图片/视频对口型 enthält zwei Tools:

Übergib Authorization, video_url und audio_url an create_media_sync. Speichere data.id aus der Antwort und verwende es als jobId. Das Erstellen eines Auftrags verbraucht API-Credits.

• processing: warten und dieselbe jobId erneut abfragen.
• completed: data.result_url lesen.
• failed: data.error_message lesen.

Rufe create_media_sync bei einem Timeout oder während der Verarbeitung nicht erneut auf. Sonst können doppelte Aufträge und Kosten entstehen.

Text-zu-synchronisiertem-Video-Workflow

Du kannst die beiden Store-Plugins wie folgt verbinden oder das private Plugin FishAudio 文字对口型 importieren, das TTS und Lippensynchronisation in einem Erstellungsaufruf kombiniert:

Text + Voice ID → FishAudio TTS 文字转语音 → audio_url
Video URL + audio_url → create_media_sync → data.id
jobId speichern → 15–30 s warten → get_media_sync_job
completed: data.result_url | failed: data.error_message

Lege für automatisches Polling eine maximale Anzahl von Abfragen und ein Gesamt-Timeout fest.

Das private Plugin verwendet create_text_lip_sync und anschließend get_text_lip_sync_job. Verwende für jeden neuen Auftrag einen neuen Idempotency-Key; nutze denselben Wert nur beim Wiederholen exakt derselben Anfrage.

Medien-URLs und Key-Sicherheit

Video- und Audio-URLs müssen vom Fish-Audio-Dienst direkt heruntergeladen werden können. Webseiten, lokale Pfade und abgelaufene signierte URLs funktionieren nicht. Temporäre Coze-URLs müssen bis zum Abschluss des Downloads gültig bleiben.

Authorization kann in Coze-Unterhaltungen, Debug- oder Laufzeitprotokollen erscheinen. Erstelle einen separaten Coze-Key, teile keine Screenshots oder Vorlagen mit echtem Key und rotiere oder widerrufe Test-Keys. Hinterlege niemals einen gemeinsamen Key in einem öffentlichen Plugin.

Fehlerbehebung

• 401: Format Bearer , zusätzliche Leerzeichen und Gültigkeit des Keys prüfen.
• 402: API-Credits prüfen; Mitglieds- und API-Credits sind getrennt.
• Mediendownload fehlgeschlagen: direkten Zugriff und Gültigkeitsdauer der URL prüfen.
• Weiterhin processing: dieselbe jobId abfragen, keinen neuen Auftrag erstellen.
• Key im Protokoll: Key widerrufen und einen neuen Coze-Key erstellen.

Erweitert: TTS HTTP API direkt aufrufen

Ein Coze-HTTP-Knoten kann POST https://kittaai.com/v1/audio/speech mit Authorization und Content-Type: application/json aufrufen. Sende model, voice, input und response_format: "mp3"; konfiguriere die Antwort als Datei oder Binärwert statt JSON.

Verwandte Dokumentation

• OpenAI-kompatibles TTS
• Lip Sync API
• Benutzerdefinierte Stimme erstellen
• Coze Plugin Store