Hoppa till huvudinnehåll

Introduktion

Fish TTS är en AI-ljudtjänst från Ace Data Cloud, Fish talgenereringstjänst. Genom Ace Data Clouds enhetliga API kan du snabbt integrera Fish TTS med Python för att omvandla text till tal, använda olika röster och anpassa ljudet.

Förutsättningar

  • Ha ett Ace Data Cloud konto och skaffa en API-token
  • Python 3.7 eller senare
  • Installera requests-biblioteket: pip install requests

Grundläggande användning

Huvudendpoint för Fish TTS API är:
POST https://api.acedata.cloud/fish/audios
Detta exempel använder modellen fish-tts. Tillgängliga modeller inkluderar: fish-tts. Fullständigt Python-exempel:
import requests

url = "https://api.acedata.cloud/fish/audios"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "action": "speech",
    "prompt": "你好,欢迎使用 Ace Data Cloud 的语音合成服务",
    "voice_id": "d7900c21663f485ab63ebdb7e5905036",
    "model": "fish-tts"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Byt ut YOUR_API_TOKEN mot den faktiska token du fått från Ace Data Cloud-plattformen.

Svarshantering

Vid lyckad anrop returnerar API:et data i JSON-format. Kontrollera HTTP-statuskoden:
if response.status_code == 200:
    result = response.json()
    print("Anrop lyckades:", result)
else:
    print(f"Anrop misslyckades, statuskod: {response.status_code}")
    print(response.text)

Avancerad användning

För API:er som stödjer asynkrona uppgifter kan du få resultat via en callback-URL:
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Resultatet skickas till din server via callback-URL

Felhantering

Vanliga felkoder:
StatuskodBeskrivning
401Autentisering misslyckades, kontrollera API-token
403Otillräckligt saldo eller ingen åtkomst
429För många förfrågningar
500Intern serverfel

Andra endpoints

Fish TTS-tjänsten erbjuder även följande endpoints:
  • POST https://api.acedata.cloud/fish/voices
  • POST https://api.acedata.cloud/fish/tasks

Nästa steg