Vai al contenuto principale

​
Introduzione

Fish TTS è un servizio audio AI fornito da Ace Data Cloud, un servizio di sintesi vocale Fish. Attraverso l’API unificata di Ace Data Cloud, puoi integrare rapidamente Fish TTS con JavaScript per realizzare funzionalità di sintesi vocale da testo, diverse tonalità vocali, voci personalizzate e altro.

​
Prerequisiti

  • Possedere un account Ace Data Cloud e ottenere un API Token
  • Ambiente Node.js 18+ o browser moderno

​
Uso Base

L’endpoint principale per chiamare l’API Fish TTS è: 
POST https://api.acedata.cloud/fish/audios
Questo esempio utilizza il modello fish-tts.
Modelli disponibili: fish-tts. Esempio completo di codice JavaScript: 
const response = await fetch("https://api.acedata.cloud/fish/audios", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "action": "speech",
  "prompt": "你好，欢迎使用 Ace Data Cloud 的语音合成服务",
  "voice_id": "d7900c21663f485ab63ebdb7e5905036",
  "model": "fish-tts"
}),
});

const result = await response.json();
console.log(result);
Sostituisci YOUR_API_TOKEN con il token reale ottenuto dalla piattaforma Ace Data Cloud.

​
Gestione della Risposta

Si consiglia di verificare lo status della risposta e gestire gli errori: 
if (response.ok) {
  const result = await response.json();
  console.log("Chiamata riuscita:", result);
} else {
  console.error(`Chiamata fallita, codice di stato: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Wrapping in Node.js

Si consiglia di incapsulare in una funzione riutilizzabile: 
async function callFishTTS(data) {
  const response = await fetch("https://api.acedata.cloud/fish/audios", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

​
Gestione degli Errori

Codici di errore comuni:
Codice StatoDescrizione
401Autenticazione fallita, controlla API Token
403Saldo insufficiente o accesso negato
429Limite di frequenza richieste superato
500Errore interno del server

​
Passi Successivi