> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Fish Model Get API 接続説明

> Fish voice generation API guide - Ace Data Cloud

本インターフェースは [Fish Audio 公式 Model API](https://docs.fish.audio/resources/api-reference/model) に基づいており、**`_id` による単一クローン音色の完全な詳細を照会する**ために使用されます。アドレスは `GET https://api.acedata.cloud/fish/model/{id}` です。

> 音色の作成については [Fish Model Create API](https://platform.acedata.cloud/documents/fish-model) を参照してください；ページネーション検索については [Fish Model Query API](https://platform.acedata.cloud/documents/fish-model-query) を参照してください。

## 申請プロセス

Fish Model API を使用するには、まず [Ace Data Cloud コンソール](https://platform.acedata.cloud/console/applications) で API トークンを取得し、保管してください。

![](https://cdn.acedata.cloud/dvc3cg.jpg)

まだログインまたは登録していない場合、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。

**1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。** 初回申請時には無料のクレジットが付与され、無料で体験できます；クレジットが不足した場合は [コンソール](https://platform.acedata.cloud/console/coin) で一般残高をチャージできます。

> 📘 完全なドキュメント：[Fish Model API →](https://platform.acedata.cloud/services/fish)

## パスパラメータ

| パラメータ | 必須 | 説明 |
| - | - | - |
| `id` | はい | 音色の `_id`（32桁の16進数文字列）。[Fish Model Create](https://platform.acedata.cloud/documents/fish-model) 作成時に返されるか、[Fish Model Query](https://platform.acedata.cloud/documents/fish-model-query) で取得できます。 |

リクエストボディなし、クエリパラメータなし。

## 例：公開されたスペイン語音色の完全な詳細を取得

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

返却（実測、`samples[].audio` の署名クエリ文字列を削除して読みやすくしています）：

```json theme={null}
{
  "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
  "type": "tts",
  "title": "Valentino Narración Biblica Fer",
  "description": "落ち着いた、精神的なトーンを持つ成熟した権威ある男性の声。宗教的なナレーション、教育コンテンツ、スペイン語でのプロフェッショナルなストーリーテリングに適しています。",
  "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"
  }
}
```

取得した `_id` を [Fish TTS](https://platform.acedata.cloud/documents/fish-tts) の `reference_id` に直接渡すことで、同じ音色の音声を合成できます：

```shell theme={null}
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"
  }'
```

## リストインターフェースとの違い

| フィールド | `GET /fish/model`（リスト） | `GET /fish/model/{id}`（詳細） |
| - | - | - |
| `samples[].audio` | 短期 R2 キャッシュ URL | 現在の署名付き R2 直リンク（クエリ署名を含む） |
| `unliked` / `liked` / `marked` / `dmca_taken_down` | 同様に存在 | 同様に存在 |
| `default_text` / `lock_visibility` | 同様に存在 | 同様に存在 |

試聴だけが必要な場合、リストインターフェースの `samples[].audio` で十分です；より安定したダウンロードリンクが必要な場合は、このインターフェースを使用することをお勧めします。

## 応答フィールド（抜粋）

| フィールド | 型 | 説明 |
| - | - | - |
| `_id` | string | 音色 ID（`/fish/tts` の `reference_id` 用）。 |
| `type` | string | モデルタイプ、通常は `tts`。 |
| `title` | string | 音色名。 |
| `description` | string | 長い説明。 |
| `state` | string | 訓練状態：`trained` は使用可能、`training` はまだ訓練中を示します。 |
| `tags` | string\[] | 公共ライブラリのタグ。 |
| `samples` | object\[] | プリセットサンプル、`title`、`text`、`task_id`、`audio` 直リンクを含む。 |
| `languages` | string\[] | 音色が得意とする言語コード。 |
| `visibility` | string | `public` または `private`。 |
| `like_count` | integer | 公共ライブラリのいいね数。 |
| `task_count` | integer | 過去の合成回数（人気順の参考に使用可能）。 |
| `author` | object | 上流の著者情報：`_id` / `nickname` / `avatar`。 |
| `created_at` | string | ISO 8601 作成時間。 |
| `updated_at` | string | ISO 8601 最近の更新時間。 |

## 課金説明

本インターフェースは課金されません——IDによる単一音色の詳細照会は無料操作です。音色の作成（[Fish Model Create](https://platform.acedata.cloud/documents/fish-model)）も無料で、費用は [Fish TTS](https://platform.acedata.cloud/documents/fish-tts) を呼び出して音声を合成する際に使用量に応じて発生します。

## エラーハンドリング

* `400 token_mismatched`：パス内の `id` が不正な形式であるか、上流が「Model not found」と報告しています。
* `401 invalid_token`：認証トークンが存在しないか無効です。
* `404 not_found`：指定された `_id` が Fish 上流で見えない（音色が削除された、プライベート、または他のアカウントに属している）。
* `429 too_many_requests`：アカウントのレート制限が発動しました。
* `500 api_error`：サーバー内部エラーです。

存在しない ID を実際にリクエストすると、上流は直接 `400 Model not found` を返します（実測）：

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

返却：

```json theme={null}
{ "status": 400, "message": "Model not found" }
```

エラー応答の例：

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

## 結論

音色 `_id` が分かっている場合は、このインターフェースを使って完全な ModelEntity を取得します。最も一般的な使い方は：(1) `samples[].audio` を試聴する、(2) `_id` を `/fish/tts` の `reference_id` に渡して合成を完了させることです。タイトルやタグしかない場合は、まず [Fish Model Query](https://platform.acedata.cloud/documents/fish-model-query) で検索してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.