Passer au contenu principal

Introduction

Fish TTS est un service audio AI fourni par Ace Data Cloud, un service de synthèse vocale Fish. Grâce à l’API unifiée d’Ace Data Cloud, vous pouvez utiliser cURL pour appeler rapidement Fish TTS et réaliser la conversion de texte en parole, avec plusieurs voix et la personnalisation des sons.

Prérequis

  • Posséder un compte Ace Data Cloud et obtenir un Token API
  • Avoir un environnement terminal avec cURL installé

Utilisation de base

Le point d’accès principal pour appeler l’API Fish TTS est :
POST https://api.acedata.cloud/fish/audios
Cet exemple utilise le modèle fish-tts.
Les modèles disponibles incluent : fish-tts.
Exemple complet de commande cURL :
curl -X POST https://api.acedata.cloud/fish/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "speech", "prompt": "你好,欢迎使用 Ace Data Cloud 的语音合成服务", "voice_id": "d7900c21663f485ab63ebdb7e5905036", "model": "fish-tts"}'
Veuillez remplacer YOUR_API_TOKEN par le Token réel obtenu sur la plateforme Ace Data Cloud.

Exemple de réponse

Une fois l’appel réussi, les données au format JSON sont retournées, par exemple :
{
  "status": "success",
  "data": {
    ...
  }
}

Traitement de la réponse avec jq

Il est recommandé d’utiliser l’outil jq pour formater la sortie :
curl -s -X POST https://api.acedata.cloud/fish/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "speech", "prompt": "你好,欢迎使用 Ace Data Cloud 的语音合成服务", "voice_id": "d7900c21663f485ab63ebdb7e5905036", "model": "fish-tts"}' | jq .

Gestion des erreurs

Codes d’erreur courants :
Code statutDescription
401Échec d’authentification, vérifiez le Token API
403Solde insuffisant ou accès refusé
429Limite de fréquence des requêtes dépassée
500Erreur interne du serveur

Étapes suivantes