Texte vers parole (HTTP)

Clonage vocal - créer un modèle

Lip-sync - créer une tâche

Profil utilisateur

Texte vers parole (HTTP) (HTTP)

Synthèse REST avec l’ID de voix et les options du moteur.

Texte vers parole (HTTP)

Endpoint

POST /api/open/v1/speech/tts

En-têtes de requête

// Paramètres de requête
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY  // Clé API

// Paramètres de requête
Content-Type: application/msgpack
Authorization: Bearer YOUR_API_KEY  // Clé API

Paramètres de requête

Paramètres de requête d’exemple

Options disponibles :

  • • Texte vers parole (HTTP): v1, v2, s1
  • • Texte vers parole (HTTP v2): v3-turbo, v3-hd
  • • Facultatif: Synthétisez la parole avec un ID de voix et des réglages moteur facultatifs.

Données de réponse

// Données de réponse (cache=false) - 200
Content-Type: audio/mpeg
<Formats multiples>

// Données de réponse (cache=true) - 200
Content-Type: application/json
{
  "success": boolean,        // Données de réponse
  "audio_url": string,       // Parole vers texte
  "format": string,          // Formats multiples
  "characters_used": number, // Paramètres de requête
  "quota_remaining": number  // Consultez le quota API restant et les informations du compte.
}

// Échec de la requête
{
  "error": string     // Échec de la requête
}

Exemple CURL

# Paramètres de requête - Facultatif
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "fishaudio-s21pro-flash",
    "text": "Parole vers texte",
    "speed": 1.0,
    "volume": 0,
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Paramètres de requête - Options disponibles :
curl -X POST https://fishaudio.org/api/open/v1/speech/tts \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "voiceId": "your_voice_id",
    "modelId": "minimax-2.8-hd",
    "text": "Parole vers texte",
    "speed": 1.0,
    "volume": 0,
    "emotion": "calm",
    "language": "zh",
    "format": "mp3",
    "cache": false
  }' \
  --output output.mp3

# Paramètres de requête (undefined)

Débogage en ligne

Codes de statut

200: Success
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
429: Too Many Requests
500: Internal Server Error