Hoppa till huvudinnehåll

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Denna artikel beskriver integrationen för Fish Model Get API (GET /fish/model/{id}), som är helt kompatibel med Fish Audio officiella OpenAPI och används för att hämta fullständig information om en enskild klonad röst baserat på röst-ID.
För att skapa röster, se Fish Model Create API, och för paginerad lista, se Fish Model Query API.

​
Ansökningsprocess

För att använda API:et måste du först ansöka om tjänsten på motsvarande sida för Fish Model API. När du kommer till sidan klickar du på knappen “Acquire”. Om du inte är inloggad eller registrerad kommer du automatiskt att omdirigeras till inloggningssidan där du kan registrera dig och logga in. Efter inloggning eller registrering återvänder du automatiskt till den aktuella sidan. Vid första ansökan får du en gratis kvot som gör att du kan använda API:et utan kostnad.

​
Skillnader från officiella API:et

  • Autentiseringsmetod: Använder Authorization: Bearer {token}, där {token} är den nyckel som ansöks om på denna plattform.
  • Svarstruktur: Returnerar direkt Fish:s ursprungliga ModelEntity-objekt utan plattformsomslag; vid fel används plattformens standardstruktur {success:false, error:{code,message}, trace_id}.
  • Sökvägsparameter: {id} är röstens _id, som returneras vid skapande via Fish Model Create API eller erhålls vid paginerad sökning via Fish Model Query API.

​
Exempel på förfrågan

curl 'https://api.xhuoapi.ai/v1/fish/model/d7900c21663f485ab63ebdb7e5905036' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}'
Byt bara ut {id} i URL:en mot det specifika röst-ID:t, inga ytterligare query-parametrar eller request body krävs.

​
Exempel på svar

Ett lyckat svar returnerar direkt Fish-plattformens ModelEntity-objekt: 
{
  "_id": "d7900c21663f485ab63ebdb7e5905036",
  "type": "tts",
  "title": "我的克隆音色",
  "description": "用一段播客录音克隆的音色",
  "cover_image": "https://example.com/cover.png",
  "train_mode": "fast",
  "state": "trained",
  "tags": [],
  "samples": [
    {
      "audio": "https://example.com/sample-voice.mp3",
      "text": ""
    }
  ],
  "created_at": "2025-05-09T12:34:56.789Z",
  "updated_at": "2025-05-09T12:34:56.789Z",
  "languages": ["zh", "en"],
  "visibility": "private",
  "lock_visibility": false,
  "default_text": "",
  "default_mode": "fast",
  "like_count": 0,
  "mark_count": 0,
  "shared_count": 0,
  "task_count": 0,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "00000000000000000000000000000000",
    "nickname": "",
    "avatar": ""
  }
}
Det returnerade _id kan användas som värdet för fältet reference_id i efterföljande Fish TTS API för att syntetisera tal med den klonade rösten.

​
Prissättningsinformation

Detta API är kostnadsfritt — att hämta röstinformation via ID är gratis. Endast POST /fish/model där voices-fältet används i request body för att skapa nya röster debiteras.

​
Felhantering

  • 400 token_mismatched: Saknade eller ogiltiga förfrågningsparametrar.
  • 400 api_not_implemented: Förfrågningsmetod eller parametrar stöds inte för tillfället.
  • 401 invalid_token: Saknad eller ogiltig autentiseringsinformation.
  • 404 not_found: Angivet _id finns inte eller är inte synligt för det aktuella kontot.
  • 429 too_many_requests: Överskridit hastighetsbegränsningen för kontot.
  • 500 api_error: Intern serverfel.

​
Exempel på felrespons

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

​
Slutsats

Fish Model Get API erbjuder en helt kompatibel möjlighet att hämta detaljer för en enskild röst från Fish Audio officiella API. När du har röst-ID:t kan du med detta API hämta hela ModelEntity-objektet (inklusive exempel, status, synlighet, statistikfält etc.) och tillsammans med Fish TTS API genomföra en komplett klonings- och syntesprocess.