Installez les plugins FishAudio TTS 文字转语音 et Media Sync dans Coze et utilisez votre propre API Key pour générer de l'audio et des vidéos synchronisées.

Utiliser FishAudio dans Coze

FishAudio propose deux plugins dans le magasin Coze. L'installation des plugins est la méthode recommandée ; utilisez la configuration HTTP directe uniquement pour une requête personnalisée.

Plugin	Fonction	Installation
FishAudio TTS 文字转语音	Convertir du texte en parole et renvoyer une URL audio	Ouvrir dans Coze
FishAudio 图片/视频对口型	Créer une tâche asynchrone à partir d'URL vidéo et audio	Ouvrir dans Coze

Préparer une API Key

Créez une clé dédiée à Coze sur la page de gestion API et vérifiez vos crédits API. Utilisez ce format :

Authorization: Bearer YOUR_FISH_AUDIO_API_KEY

Un espace est requis après Bearer. Chaque client utilise sa propre clé et la consommation est facturée à son compte Fish Audio.

Créer son propre plugin privé

Pour ne pas utiliser les plugins du magasin, téléchargez FishAudio TTS 文字转语音 OpenAPI, FishAudio 图片/视频对口型 OpenAPI, FishAudio 文字对口型 OpenAPI ou FishAudio 专属语音合成 OpenAPI, puis importez le fichier dans Coze comme plugin cloud fondé sur un service existant. Choisissez aucune autorisation et fournissez l'Authorization du client à l'exécution. Consultez le guide anglais.

La méthode recommandée consiste à utiliser Importer en haut à droite ; elle ne demande que le fichier OpenAPI YAML. Si ai_plugin (JSON) apparaît à gauche et openapi (YAML) à droite, vous êtes sur la page de création par code </>. Ne laissez pas ai_plugin vide : collez le fichier *.ai-plugin.json correspondant à gauche et le fichier *.openapi.yaml de même préfixe à droite. manifest.json est uniquement l'inventaire du paquet FishAudio, pas un fichier ai_plugin.

Disponibilité actuelle : FishAudio TTS 文字转语音 et FishAudio 图片/视频对口型 sont proposés dans le magasin ; FishAudio 文字对口型 et FishAudio 专属语音合成 sont uniquement disponibles sous forme de plugins privés à importer.

Utiliser FishAudio TTS 文字转语音

Ajoutez FishAudio TTS 文字转语音 à votre espace Coze.
Ajoutez l'outil TTS à un agent ou à un workflow.
Renseignez Authorization, le texte, le Voice ID et les options souhaitées.
Reliez l'audio_url renvoyée à la lecture, au téléchargement ou à Media Sync.

Testez d'abord une phrase courte. Le Voice ID doit correspondre à une voix système valide ou à une voix personnalisée disponible dans le compte.

Utiliser FishAudio 图片/视频对口型

FishAudio 图片/视频对口型 fournit deux outils :

Outil	Fonction
`create_media_sync`	Créer une tâche à partir d'URL vidéo et audio directement téléchargeables
`get_media_sync_job`	Interroger la progression, le résultat ou l'erreur avec `jobId`

Transmettez Authorization, video_url et audio_url à create_media_sync. Enregistrez data.id et utilisez-le comme jobId. La création d'une tâche consomme des crédits API.

processing : attendre puis interroger le même jobId.
completed : lire data.result_url.
failed : lire data.error_message.

Ne rappelez pas create_media_sync après un délai d'attente ou pendant le traitement : cela peut créer et facturer une tâche en double.

Workflow texte vers vidéo synchronisée

Vous pouvez relier les deux plugins du magasin comme ci-dessous, ou importer le plugin privé FishAudio 文字对口型, qui combine TTS et synchronisation labiale dans une seule création :

Texte + Voice ID → FishAudio TTS 文字转语音 → audio_url
URL vidéo + audio_url → create_media_sync → data.id
Enregistrer jobId → attendre 15–30 s → get_media_sync_job
completed: data.result_url | failed: data.error_message

Pour un polling automatique, définissez un nombre maximal de requêtes et un délai total.

Le plugin privé utilise create_text_lip_sync, puis get_text_lip_sync_job. Utilisez un nouvel Idempotency-Key pour chaque nouvelle tâche et réutilisez-le uniquement pour réessayer exactement la même requête.

URL de médias et sécurité de la clé

Les URL vidéo et audio doivent être directement téléchargeables par Fish Audio. Les pages web, chemins locaux et URL signées expirées ne fonctionnent pas. Une URL temporaire Coze doit rester valide jusqu'à la fin du téléchargement.

Authorization peut apparaître dans les conversations, le débogage ou les journaux Coze. Créez une clé Coze dédiée, ne partagez pas de capture ou de modèle contenant une vraie clé, puis faites tourner ou révoquez les clés de test. N'intégrez jamais une clé commune dans un plugin public.

Dépannage

401 : vérifier Bearer , les espaces superflus et la validité de la clé.
402 : vérifier les crédits API, distincts des crédits d'abonnement.
Échec du téléchargement : vérifier l'accès direct et la durée de validité de l'URL.
Toujours processing : interroger le même jobId, sans recréer la tâche.
Clé visible dans les journaux : la révoquer et créer une nouvelle clé Coze.

Avancé : appeler directement l'API HTTP TTS

Un nœud HTTP Coze peut appeler POST https://fishaudio.org/v1/audio/speech avec Authorization et Content-Type: application/json. Envoyez model, voice, input et response_format: "mp3", puis configurez la réponse comme fichier ou donnée binaire, pas comme JSON.

Configuration de Coze