Fish Model Query API Integracja Opis

Ten interfejs oparty jest na Fish Audio oficjalnym Model API i służy do stronicowego przeszukiwania publicznej biblioteki dźwięków Fish lub klonów dźwięków w bieżącym koncie. Adres to GET https://api.acedata.cloud/fish/model.

Aby utworzyć dźwięk, zapoznaj się z Fish Model Create API; aby wyszukać szczegóły pojedynczego dźwięku według _id, zapoznaj się z Fish Model Get API.

Proces aplikacji

Aby korzystać z Fish Model API, najpierw przejdź do Ace Data Cloud konsoli, aby uzyskać swój token API, który należy zachować na przyszłość.

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do korzystania ze wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Pierwsze zgłoszenie otrzyma darmowy limit, aby móc skorzystać z doświadczenia; w przypadku niewystarczającego limitu można doładować saldo ogólne w konsoli.

📘 Pełna dokumentacja: Fish Model API →

Parametry zapytania

Parametr	Typ	Domyślny	Opis
`page_size`	integer	10	Liczba elementów na stronę.
`page_number`	integer	1	Numer strony zaczynający się od 1.
`title`	string	—	Wyszukiwanie według tytułu.
`tag`	string	—	Filtrowanie według pojedynczego tagu.
`self`	boolean	—	Gdy `true`, zwraca tylko dźwięki utworzone przez bieżące konto, bez dodatkowych warunków.
`author_id`	string	—	Filtrowanie według `_id` użytkownika.
`language`	string	—	Filtrowanie według języka dźwięku, np. `en`, `zh`, `es`.
`title_language`	string	—	Filtrowanie według języka tytułu.
`sort_by`	string	—	Pole sortowania, zgodne z upstream, np. `created_at`, `task_count`.

Nazewnictwo parametrów jest identyczne z upstream GET https://api.fish.audio/model, szczegóły w oficjalnej dokumentacji Fish.

Przykład 1: Domyślne stronicowanie (według `page_size`)

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

Zwrócone (testowane, całkowita liczba w bibliotece publicznej wynosi około 1,8 miliona; dla czytelności w poniższym przykładzie pominięto niektóre długie pola):

{
  "total": 1829200,
  "items": [
    {
      "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
      "type": "tts",
      "title": "Valentino Narración Biblica Fer",
      "description": "Dojrzały i autorytatywny męski głos o spokojnym, duchowym tonie...",
      "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
}

Przykład 2: Wyszukiwanie według tytułu (fuzzy search) (`title`)

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

Zwrócone (testowane):

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

Zauważ, że title to „globalne dopasowanie fuzzy”, które trafi na wszystkie dźwięki w publicznej bibliotece Fish (nie tylko na własne).

Przykład 3: Wyświetlanie tylko dźwięków utworzonych przez siebie (`self=true`)

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

Zwrócone (testowane, na bieżącym koncie znajduje się tylko 1 dźwięk):

{
  "total": 1,
  "items": [
    {
      "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
      "type": "tts",
      "title": "copilot-smoke-test",
      "description": "smoke test from 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 jest równoważne z ograniczeniem w filtrze author_id == bieżące konto upstream ID, co jest powszechnym sposobem na uzyskanie „listy moich dźwięków”.

Przykład 4: Filtrowanie według języka + tagu

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'

Górny strumień również zwróci wyniki dla tag, który nie znajduje się w słowniku tagów, ale dopasowanie jest stosunkowo luźne; jeśli liczba trafień wynosi 0, zaleca się użycie dopasowania przybliżonego dla title.

Pola odpowiedzi

Każdy element w items[] to pełny obiekt ModelEntity, często używane pola:

Pole	Typ	Opis
`_id`	string	ID głosu, jako wartość `reference_id` w `/fish/tts`.
`type`	string	Typ modelu, zazwyczaj `tts`.
`title`	string	Nazwa głosu.
`description`	string	Opis głosu.
`state`	string	Stan treningu: `trained` oznacza dostępny.
`tags`	string[]	Tagi z publicznej biblioteki.
`languages`	string[]	Języki, w których głos jest biegły.
`visibility`	string	`public` lub `private`.
`samples`	object[]	Przykładowe próbki (zawierające bezpośrednie linki do `audio`).
`like_count`	integer	Liczba polubień w publicznej bibliotece.
`task_count`	integer	Liczba historycznych syntez.
`author`	object	Informacje o autorze: `'_id'` / `nickname` / `avatar`.
`total`（górny poziom）	integer	Całkowita liczba spełniająca warunki.
`has_more`	boolean?	Wskazanie paginacji, może być `null`. Zaleca się obliczenie całkowitej liczby stron jako `total / page_size`.

Opis opłat

Ten interfejs nie jest płatny — zapytania o listę głosów są darmowe. Tworzenie głosów (Fish Model Create) również jest darmowe, opłaty powstają tylko podczas wywoływania Fish TTS do syntezowania głosu.

Obsługa błędów

400 token_mismatched：Brak lub nieprawidłowe parametry żądania.
401 invalid_token：Token autoryzacyjny nie istnieje lub jest nieprawidłowy.
429 too_many_requests：Przekroczono limit szybkości konta.
500 api_error：Błąd wewnętrzny serwera.

Przykład odpowiedzi błędu:

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

Wnioski

Aby wybrać głos z publicznej biblioteki Fish do podania do /fish/tts jako reference_id, najpierw użyj tego interfejsu w połączeniu z title / tag / language, aby zlokalizować docelowe _id, a następnie użyj Fish Model Get do uzyskania próbek do odsłuchu. Aby wylistować własne stworzone głosy, wystarczy przekazać self=true.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Fish Model Query API Integracja Opis

Proces aplikacji

Parametry zapytania

Przykład 1: Domyślne stronicowanie (według `page_size`)

Przykład 2: Wyszukiwanie według tytułu (fuzzy search) (`title`)

Przykład 3: Wyświetlanie tylko dźwięków utworzonych przez siebie (`self=true`)

Przykład 4: Filtrowanie według języka + tagu

Pola odpowiedzi

Opis opłat

Obsługa błędów

Wnioski

​Proces aplikacji

​Parametry zapytania

​Przykład 1: Domyślne stronicowanie (według page_size)

​Przykład 2: Wyszukiwanie według tytułu (fuzzy search) (title)

​Przykład 3: Wyświetlanie tylko dźwięków utworzonych przez siebie (self=true)

​Przykład 4: Filtrowanie według języka + tagu

​Pola odpowiedzi

​Opis opłat

​Obsługa błędów

​Wnioski

Proces aplikacji

Parametry zapytania

Przykład 1: Domyślne stronicowanie (według `page_size`)

Przykład 2: Wyszukiwanie według tytułu (fuzzy search) (`title`)

Przykład 3: Wyświetlanie tylko dźwięków utworzonych przez siebie (`self=true`)

Przykład 4: Filtrowanie według języka + tagu

Pola odpowiedzi

Opis opłat

Obsługa błędów

Wnioski