Fish Model Get API Dokumentacja integracji

Ten interfejs oparty jest na oficjalnym API Model Fish Audio i służy do wyszukiwania pełnych szczegółów pojedynczego klonu dźwięku według _id. Adres to GET https://api.acedata.cloud/fish/model/{id}.

Aby utworzyć dźwięk, zapoznaj się z Fish Model Create API; aby przeszukiwać strony, zapoznaj się z Fish Model Query API.

Proces aplikacji

Aby korzystać z Fish Model API, najpierw przejdź do konsoli Ace Data Cloud, 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 wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Pierwsze zgłoszenie otrzymuje darmowy limit, aby móc korzystać z usługi za darmo; w przypadku niewystarczającego limitu można doładować saldo ogólne w konsoli.

📘 Pełna dokumentacja: Fish Model API →

Parametry ścieżki

Parametr	Wymagane	Opis
`id`	Tak	`_id` dźwięku (32-znakowy ciąg szesnastkowy). Można go uzyskać podczas tworzenia przez Fish Model Create lub wyszukiwania przez Fish Model Query.

Brak ciała żądania, brak parametrów zapytania.

Przykład: Pobranie pełnych szczegółów publicznego dźwięku w języku hiszpańskim

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

Odpowiedź (testowana, usunięto podpisane ciągi zapytania z samples[].audio dla lepszej czytelności):

{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "Dojrzały i autorytatywny męski głos o spokojnym, duchowym tonie. Doskonale nadaje się do narracji religijnych, treści edukacyjnych i profesjonalnego opowiadania w języku hiszpańskim.",
  "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"
  }
}

Uzyskane _id można bezpośrednio podać do reference_id w Fish TTS, aby wygenerować głos o tym samym dźwięku:

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

Różnice w interfejsie listy

Pole	`GET /fish/model` (lista)	`GET /fish/model/{id}` (szczegóły)
`samples[].audio`	Krótkoterminowy URL R2	Bezpośredni link R2 z podpisem (z ciągiem zapytania)
`unliked` / `liked` / `marked` / `dmca_taken_down`	Istnieje również	Istnieje również
`default_text` / `lock_visibility`	Istnieje również	Istnieje również

Jeśli chcesz tylko posłuchać, samples[].audio w interfejsie listy jest wystarczające; dla bardziej stabilnego linku do pobrania, zaleca się użycie tego interfejsu.

Pola odpowiedzi (wyciąg)

Pole	Typ	Opis
`_id`	string	ID dźwięku (używane w `/fish/tts` jako `reference_id`).
`type`	string	Typ modelu, zazwyczaj `tts`.
`title`	string	Nazwa dźwięku.
`description`	string	Długi opis.
`state`	string	Stan treningu: `trained` oznacza dostępność, `training` oznacza, że nadal trwa trening.
`tags`	string[]	Tagi w publicznej bibliotece.
`samples`	object[]	Wstępnie zdefiniowane próbki, zawierające `title`, `text`, `task_id`, `audio` bezpośredni link.
`languages`	string[]	Kody języków, w których dźwięk jest biegły.
`visibility`	string	`public` lub `private`.
`like_count`	integer	Liczba polubień w publicznej bibliotece.
`task_count`	integer	Liczba historycznych syntez (można użyć do odniesienia w popularności).
`author`	object	Informacje o autorze: `_id` / `nickname` / `avatar`.
`created_at`	string	Czas utworzenia w formacie ISO 8601.
`updated_at`	string	Czas ostatniej aktualizacji w formacie ISO 8601.

Informacje o opłatach

Ten interfejs nie jest płatny — zapytanie o szczegóły pojedynczego dźwięku według ID jest darmową operacją. Tworzenie dźwięku (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：Ścieżka zawiera id, które nie jest w prawidłowym formacie, lub upstream zgłasza „Model not found”.
401 invalid_token：Token autoryzacyjny nie istnieje lub jest nieważny.
404 not_found：Określony _id jest niewidoczny w upstream Fish (brzmienie zostało usunięte, jest prywatne lub należy do innego konta).
429 too_many_requests：Wyzwolono limit szybkości konta.
500 api_error：Błąd wewnętrzny serwera.

Podczas rzeczywistego żądania nieistniejącego ID, upstream bezpośrednio zwraca 400 Model not found (testowane):

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

Zwraca:

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

Przykład błędnej odpowiedzi:

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

Wnioski

Znając _id brzmienia, można bezpośrednio użyć tego interfejsu do uzyskania pełnego ModelEntity, najczęstsze zastosowania to: (1) odsłuch samples[].audio, (2) podanie _id do reference_id w /fish/tts w celu zakończenia syntezy. Jeśli masz tylko tytuł lub tagi, najpierw użyj Fish Model Query do wyszukiwania.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Fish Model Get API Dokumentacja integracji

Proces aplikacji

Parametry ścieżki

Przykład: Pobranie pełnych szczegółów publicznego dźwięku w języku hiszpańskim

Różnice w interfejsie listy

Pola odpowiedzi (wyciąg)

Informacje o opłatach

Obsługa błędów

Wnioski

​Proces aplikacji

​Parametry ścieżki

​Przykład: Pobranie pełnych szczegółów publicznego dźwięku w języku hiszpańskim

​Różnice w interfejsie listy

​Pola odpowiedzi (wyciąg)

​Informacje o opłatach

​Obsługa błędów

​Wnioski

Proces aplikacji

Parametry ścieżki

Przykład: Pobranie pełnych szczegółów publicznego dźwięku w języku hiszpańskim

Różnice w interfejsie listy

Pola odpowiedzi (wyciąg)

Informacje o opłatach

Obsługa błędów

Wnioski