Fish Model Get API Documentation

Cette interface est basée sur Fish Audio Official Model API et est utilisée pour interroger les détails complets d’un clone de voix par _id. L’adresse est GET https://api.acedata.cloud/fish/model/{id}.

Pour créer une voix, veuillez consulter Fish Model Create API ; pour la recherche paginée, veuillez consulter Fish Model Query 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 séparément 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 chemin

Paramètre	Obligatoire	Description
`id`	Oui	`_id` de la voix (chaîne hexadécimale de 32 caractères). Peut être obtenu lors de la création via Fish Model Create ou récupéré via Fish Model Query.

Pas de corps de requête, pas de paramètres de requête.

Exemple : Récupérer les détails complets d’une voix espagnole publique

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

Retour (testé, la chaîne de requête de signature dans samples[].audio a été supprimée pour faciliter la lecture) :

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "Une voix masculine mature et autoritaire avec un ton calme et spirituel. Elle est bien adaptée pour la narration religieuse, le contenu éducatif et le storytelling professionnel en espagnol.",
  "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
  "train_mode": "fast",
  "state": "trained",
  "tags": [
    "male", "old", "narration", "calm", "serious",
    "authoritative", "professional", "clear", "Spanish"
  ],
  "samples": [
    {
      "title": "Default Sample",
      "text": "Hermanos míos, recordemos las palabras del Señor en estos tiempos difíciles. Como dice la Escritura, la fe mueve montañas, y el amor de Dios nos guía en cada paso del camino. Mantengamos firme nuestra confianza en Su divina providencia.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "Hermanos míos, recordemos las palabras del Señor...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

L’_id obtenu peut être directement utilisé comme reference_id dans Fish TTS pour synthétiser une voix identique :

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Hermanos míos, hoy es un buen día.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

Différences avec l’interface de liste

Champ	`GET /fish/model` (liste)	`GET /fish/model/{id}` (détails)
`samples[].audio`	URL de cache R2 à court terme	Lien direct R2 signé (avec signature de requête)
`unliked` / `liked` / `marked` / `dmca_taken_down`	Existe également	Existe également
`default_text` / `lock_visibility`	Existe également	Existe également

Si vous souhaitez simplement écouter, le samples[].audio de l’interface de liste est suffisant ; pour un lien de téléchargement plus stable, il est recommandé d’utiliser cette interface.

Champs de réponse (extraits)

Champ	Type	Description
`_id`	string	ID de la voix (utilisé pour `reference_id` de `/fish/tts`).
`type`	string	Type de modèle, généralement `tts`.
`title`	string	Nom de la voix.
`description`	string	Description longue.
`state`	string	État d’entraînement : `trained` signifie disponible, `training` signifie en cours d’entraînement.
`tags`	string[]	Étiquettes de la bibliothèque publique.
`samples`	object[]	Échantillons prédéfinis, contenant `title`, `text`, `task_id`, `audio` lien direct.
`languages`	string[]	Codes de langues dans lesquelles la voix excelle.
`visibility`	string	`public` ou `private`.
`like_count`	integer	Nombre de likes dans la bibliothèque publique.
`task_count`	integer	Nombre total de synthèses historiques (peut être utilisé pour le tri par popularité).
`author`	object	Informations sur l’auteur : `_id` / `nickname` / `avatar`.
`created_at`	string	Date de création au format ISO 8601.
`updated_at`	string	Date de dernière mise à jour au format ISO 8601.

Informations de facturation

Cette interface n’entraîne pas de frais - interroger les détails d’une voix par ID est une opération gratuite. La création de voix (Fish Model Create) est également gratuite, les frais ne sont générés que lors de l’appel de Fish TTS pour synthétiser la voix.

Gestion des erreurs

400 token_mismatched : L’id dans le chemin n’est pas au format valide, ou l’amont renvoie « Modèle non trouvé ».
401 invalid_token : Le token d’authentification n’existe pas ou est invalide.
404 not_found : Le _id spécifié n’est pas visible en amont sur Fish (le timbre a été supprimé, est privé, ou appartient à un autre compte).
429 too_many_requests : Limite de taux déclenchée pour le compte.
500 api_error : Erreur interne du serveur.

Lorsqu’une demande est faite pour un ID inexistant, l’amont renvoie directement 400 Model not found (testé) :

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

Retour :

{ "status": 400, "message": "Model not found" }

Exemple de réponse d’erreur :

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

Conclusion

Lorsque vous connaissez le _id du timbre, utilisez directement cette interface pour obtenir le ModelEntity complet, les usages les plus courants sont : (1) écouter samples[].audio, (2) fournir le _id à reference_id de /fish/tts pour compléter la synthèse. Si vous n’avez que le titre ou les étiquettes, veuillez d’abord utiliser Fish Model Query pour effectuer une recherche.

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Proxy

Avancé

Coding

Fish Model Get API Documentation

Processus de demande

Paramètres de chemin

Exemple : Récupérer les détails complets d’une voix espagnole publique

Différences avec l’interface de liste

Champs de réponse (extraits)

Informations de facturation

Gestion des erreurs

Conclusion

​Processus de demande

​Paramètres de chemin

​Exemple : Récupérer les détails complets d’une voix espagnole publique

​Différences avec l’interface de liste

​Champs de réponse (extraits)

​Informations de facturation

​Gestion des erreurs

​Conclusion

Processus de demande

Paramètres de chemin

Exemple : Récupérer les détails complets d’une voix espagnole publique

Différences avec l’interface de liste

Champs de réponse (extraits)

Informations de facturation

Gestion des erreurs

Conclusion