Fish Model Get API Integrationsbeskrivning

Detta gränssnitt är baserat på Fish Audio officiella Model API och används för att hämta fullständiga detaljer om en enskild klonröst baserat på _id. Adressen är GET https://api.acedata.cloud/fish/model/{id}.

För att skapa röster, vänligen se Fish Model Create API; för paginerad sökning, se Fish Model Query API.

Ansökningsprocess

För att använda Fish Model API, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du kan spara för framtida bruk.

Om du inte är inloggad eller registrerad kommer du automatiskt att omdirigeras till inloggningssidan där du blir inbjuden att registrera dig och logga in. När detta är klart kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, det behövs ingen separat ansökan för varje tjänst. Första ansökan ger en gratis kvot för att prova på; när kvoten är slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: Fish Model API →

Sökvägsparametrar

Parameter	Obligatorisk	Beskrivning
`id`	Ja	Röstens `_id` (32-tecken hexadecimalt sträng). Kan erhållas vid skapande genom Fish Model Create eller genom att hämta det via Fish Model Query.

Ingen begäran kropp, inga sökparametrar.

Exempel: Hämta fullständiga detaljer om en offentlig spansktalande röst

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

Svar (testat, signaturquery-strängen i samples[].audio har tagits bort för läsbarhet):

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "En mogen och auktoritativ manlig röst med en lugn, andlig ton. Den är väl lämpad för religiös berättande, utbildningsinnehåll och professionell berättande på spanska.",
  "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"
  }
}

Det erhållna _id kan direkt användas som reference_id i Fish TTS för att syntetisera tal med samma röst:

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"
  }'

Skillnader från listgränssnittet

Fält	`GET /fish/model` (lista)	`GET /fish/model/{id}` (detaljer)
`samples[].audio`	Kortvarig R2-cache URL	Direktlänk med signatur (inklusive query-signatur)
`unliked` / `liked` / `marked` / `dmca_taken_down`	Finns också	Finns också
`default_text` / `lock_visibility`	Finns också	Finns också

Om du bara vill lyssna på ett exempel är samples[].audio i listgränssnittet tillräckligt; för mer stabila nedladdningslänkar rekommenderas att använda detta gränssnitt.

Svarsfält (utdrag)

Fält	Typ	Beskrivning
`_id`	string	Röst-ID (används för `/fish/tts` som `reference_id`).
`type`	string	Modelltyp, vanligtvis `tts`.
`title`	string	Röstnamn.
`description`	string	Lång beskrivning.
`state`	string	Träningsstatus: `trained` betyder tillgänglig, `training` betyder att den fortfarande tränas.
`tags`	string[]	Offentliga biblioteksetiketter.
`samples`	object[]	Förinställda exempel, inklusive `title`, `text`, `task_id`, `audio` direktlänk.
`languages`	string[]	Språk koden som rösten är bra på.
`visibility`	string	`public` eller `private`.
`like_count`	integer	Antal gillningar i det offentliga biblioteket.
`task_count`	integer	Antal historiska synteser (kan användas för populäritetsranking).
`author`	object	Information om författaren: `_id` / `nickname` / `avatar`.
`created_at`	string	ISO 8601 skapelsedatum.
`updated_at`	string	ISO 8601 senaste uppdateringsdatum.

Avgiftsbeskrivning

Detta gränssnitt debiteras inte - att hämta detaljer om en röst baserat på ID är en gratis åtgärd. Att skapa röster (Fish Model Create) är också gratis, avgifter uppstår endast vid anrop av Fish TTS för att syntetisera tal.

Felhantering

400 token_mismatched：id i sökvägen är inte i giltigt format, eller upstream rapporterar “Model not found”.
401 invalid_token：Autentiseringstoken saknas eller är ogiltig.
404 not_found：Angivet _id är inte synligt i Fish upstream (rösten har tagits bort, är privat eller tillhör ett annat konto).
429 too_many_requests：Kontots hastighetsbegränsning har utlösts.
500 api_error：Internt serverfel.

När man faktiskt begär ett icke-existerande ID returnerar upstream direkt 400 Model not found (testat):

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

Svar:

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

Exempel på felrespons:

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

Slutsats

När man känner till röstens _id används denna endpoint direkt för att hämta komplett ModelEntity, de vanligaste användningsfallen är: (1) lyssna på samples[].audio, (2) mata _id till /fish/tts som reference_id för att slutföra syntesen. Om man bara har titel eller taggar, använd först Fish Model Query för att söka.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

Fish Model Get API Integrationsbeskrivning

Ansökningsprocess

Sökvägsparametrar

Exempel: Hämta fullständiga detaljer om en offentlig spansktalande röst

Skillnader från listgränssnittet

Svarsfält (utdrag)

Avgiftsbeskrivning

Felhantering

Slutsats

​Ansökningsprocess

​Sökvägsparametrar

​Exempel: Hämta fullständiga detaljer om en offentlig spansktalande röst

​Skillnader från listgränssnittet

​Svarsfält (utdrag)

​Avgiftsbeskrivning

​Felhantering

​Slutsats

Ansökningsprocess

Sökvägsparametrar

Exempel: Hämta fullständiga detaljer om en offentlig spansktalande röst

Skillnader från listgränssnittet

Svarsfält (utdrag)

Avgiftsbeskrivning

Felhantering

Slutsats