Fish Model Query API Documentation

Cette interface est basée sur Fish Audio Official Model API et est utilisée pour rechercher par pagination dans la bibliothèque de voix publiques de Fish ou les voix clonées sous le compte actuel. L’adresse est GET https://api.acedata.cloud/fish/model.

Pour créer une voix, veuillez consulter Fish Model Create API ; pour interroger les détails d’une voix unique par _id, veuillez consulter Fish Model Get API.

Processus de demande

Pour utiliser l’API Fish Model, commencez par obtenir votre API Token sur Ace Data Cloud Console pour le garder en réserve.

Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle. Un API Token suffit pour appeler tous les services de la plateforme, il n’est pas nécessaire de demander un pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; lorsque le quota est insuffisant, vous pouvez recharger le solde général dans la console.

📘 Documentation complète : Fish Model API →

Paramètres de requête

Paramètre	Type	Par défaut	Description
`page_size`	integer	10	Nombre d’éléments par page.
`page_number`	integer	1	Numéro de page à partir de 1.
`title`	string	—	Recherche floue par titre.
`tag`	string	—	Filtrer par un seul tag.
`self`	boolean	—	Si `true`, retourne uniquement les voix créées par le compte actuel, sans conditions supplémentaires.
`author_id`	string	—	Filtrer par l’`_id` de l’utilisateur en amont.
`language`	string	—	Filtrer par langue de la voix, comme `en`, `zh`, `es`.
`title_language`	string	—	Filtrer par langue du titre.
`sort_by`	string	—	Champ de tri, identique à l’amont, comme `created_at`, `task_count`.

La nomenclature des paramètres est identique à celle de l’amont GET https://api.fish.audio/model, voir Documentation officielle de Fish.

Exemple 1 : Pagination par défaut (par `page_size`)

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'page_size=2'

Retour (testé, le total de la bibliothèque publique est d’environ 1,8 million d’éléments ; pour des raisons de lisibilité, certains champs longs ont été omis dans l’exemple ci-dessous) :

{
  "total": 1829200,
  "items": [
    {
      "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
      "type": "tts",
      "title": "Valentino Narración Biblica Fer",
      "description": "Une voix masculine mature et autoritaire avec un ton calme et spirituel...",
      "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
      "train_mode": "fast",
      "state": "trained",
      "tags": ["male", "old", "narration", "calm", "Spanish"],
      "samples": [
        {
          "title": "Default Sample",
          "text": "Hermanos míos, recordemos las palabras del Señor...",
          "task_id": "59ce7df6935c42249759327ddf70f37b",
          "audio": "https://platform.r2.fish.audio/task/59ce7df6935c42249759327ddf70f37b.mp3"
        }
      ],
      "languages": ["es"],
      "visibility": "public",
      "like_count": 4344,
      "task_count": 708461,
      "author": {
        "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
        "nickname": "Fernando Caicedo"
      }
    },
    {
      "_id": "90e65eaaf50e4470b8e6d43ee6afd7d5",
      "type": "tts",
      "title": "Super Smash Bros. 4/Ultimate Announcer",
      "tags": ["male", "old", "announcer", "gaming", "cinematic"],
      "languages": ["en"],
      "visibility": "public"
    }
  ],
  "has_more": null
}

Exemple 2 : Recherche floue par titre (`title`)

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'title=narration' \
  --data-urlencode 'page_size=2'

Retour (testé) :

{
  "total": 161,
  "items": [
    {
      "_id": "fb8fe4a94658429d9be70efd4eec35a2",
      "type": "tts",
      "title": "Miles Morales ( Narration Paw )",
      "tags": ["male", "middle-aged", "entertainment", "storytelling", "Children's Content"],
      "languages": ["en"],
      "visibility": "public",
      "task_count": 770
    },
    {
      "_id": "76b55591c758444cb95253708696dfad",
      "type": "tts",
      "title": "Joe NARRATION",
      "tags": ["male", "middle-aged", "narration", "deep", "raspy"],
      "languages": ["en"],
      "visibility": "public"
    }
  ],
  "has_more": null
}

Notez que title est un « match flou global », qui touchera toutes les voix de la bibliothèque publique de Fish (pas seulement les vôtres).

Exemple 3 : Lister uniquement les voix créées par soi-même (`self=true`)

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'self=true' \
  --data-urlencode 'page_size=5'

Retour (testé, il n’y a qu’une seule voix sous le compte actuel) :

{
  "total": 1,
  "items": [
    {
      "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
      "type": "tts",
      "title": "copilot-smoke-test",
      "description": "test de fumée depuis api.acedata.cloud",
      "state": "trained",
      "languages": ["zh"],
      "visibility": "public",
      "samples": [
        {
          "title": "Default Sample",
          "text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
          "task_id": "6a1bf398dfae49dca0e23159214342a0",
          "audio": "https://platform.r2.fish.audio/task/6a1bf398dfae49dca0e23159214342a0.mp3"
        }
      ],
      "created_at": "2026-05-10T03:52:55.601000Z",
      "author": {
        "_id": "780f2b2f862d41a08c0507bbbda77eb6",
        "nickname": "Penny Conrad"
      }
    }
  ],
  "has_more": null
}

self=true équivaut à limiter le filtrage à author_id == ID en amont du compte actuel, c’est une entrée courante pour « ma propre liste de voix ».

Exemple 4 : Filtrer par langue + tag

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'language=zh' \
  --data-urlencode 'tag=narration' \
  --data-urlencode 'page_size=5'

L’interface en amont renverra également des résultats pour les tag qui ne figurent pas dans le dictionnaire des étiquettes, mais la correspondance sera relativement lâche ; si le nombre de correspondances est de 0, il est conseillé d’utiliser un title en correspondance floue.

Champs de réponse

Chaque élément dans items[] est un objet ModelEntity complet, champs couramment utilisés :

Champ	Type	Description
`_id`	string	ID de la voix, utilisé comme valeur de `reference_id` dans `/fish/tts`.
`type`	string	Type de modèle, généralement `tts`.
`title`	string	Nom de la voix.
`description`	string	Description de la voix.
`state`	string	État d’entraînement : `trained` signifie disponible.
`tags`	string[]	Étiquettes de la bibliothèque publique.
`languages`	string[]	Langues maîtrisées par la voix.
`visibility`	string	`public` ou `private`.
`samples`	object[]	Échantillons préenregistrés (incluant des liens directs `audio`).
`like_count`	integer	Nombre de likes dans la bibliothèque publique.
`task_count`	integer	Nombre total de synthèses historiques.
`author`	object	Informations sur l’auteur en amont : `_id` / `nickname` / `avatar`.
`total` (niveau supérieur)	integer	Nombre total d’éléments satisfaisant les conditions.
`has_more`	boolean?	Indication de pagination en amont, peut être `null`. Il est conseillé de calculer le nombre total de pages avec `total / page_size`.

Informations de facturation

Cette interface n’entraîne pas de frais - la requête de liste des voix par pagination est gratuite. La création de voix (Fish Model Create) est également gratuite, des frais ne sont appliqués que lors de l’appel à Fish TTS pour la synthèse vocale en fonction de l’utilisation.

Gestion des erreurs

400 token_mismatched : Paramètres de requête manquants ou non valides.
401 invalid_token : Le token d’authentification n’existe pas ou est invalide.
429 too_many_requests : Limite de taux de compte atteinte.
500 api_error : Erreur interne du serveur.

Exemple de réponse d’erreur :

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Conclusion

Pour sélectionner une voix dans la bibliothèque publique Fish à fournir à /fish/tts comme reference_id, utilisez d’abord cette interface avec title / tag / language pour rechercher, localisez l’_id cible, puis utilisez Fish Model Get pour obtenir des échantillons à écouter. Pour lister les voix que vous avez créées, il suffit de passer self=true.

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Proxy

Avancé

Coding

Fish Model Query API Documentation

Processus de demande

Paramètres de requête

Exemple 2 : Recherche floue par titre (`title`)

Exemple 3 : Lister uniquement les voix créées par soi-même (`self=true`)

Exemple 4 : Filtrer par langue + tag

Champs de réponse

Informations de facturation

Gestion des erreurs

Conclusion

​Processus de demande

​Paramètres de requête

​Exemple 1 : Pagination par défaut (par page_size)

​Exemple 2 : Recherche floue par titre (title)

​Exemple 3 : Lister uniquement les voix créées par soi-même (self=true)

​Exemple 4 : Filtrer par langue + tag

​Champs de réponse

​Informations de facturation

​Gestion des erreurs

​Conclusion

Processus de demande

Paramètres de requête

Exemple 1 : Pagination par défaut (par `page_size`)

Exemple 2 : Recherche floue par titre (`title`)

Exemple 3 : Lister uniquement les voix créées par soi-même (`self=true`)

Exemple 4 : Filtrer par langue + tag

Champs de réponse

Informations de facturation

Gestion des erreurs

Conclusion