Fish Model Create API 連携説明

本インターフェースは Fish Audio 公式 Model API に基づき、1つの音声サンプルに基づいて長期的に再利用可能なクローン音声モデルを作成するために使用されます。エンドポイントは POST https://api.acedata.cloud/fish/model です。

参考音声を一時的に使用するだけの場合は、モデルを作成する必要はなく、Fish TTS API の references を直接使用して一度限りの即時クローンを行えます。既存の音色をページネーションで検索する場合は Fish Model Query API を参照してください。_id によって単一の音色詳細を照会する場合は Fish Model Get API を参照してください。

申請フロー

Fish Model API を使用するには、まず Ace Data Cloud コンソールにアクセスして API Token を取得し、控えておいてください。

まだログインまたは登録していない場合は、ログインページに自動的にリダイレクトされ、登録とログインを促されます。完了後、自動的に現在のページへ戻ります。 1つの API Token でプラットフォーム上のすべてのサービスを呼び出すことができ、サービスごとに個別の申請は不要です。 初回申請時には無料クレジットが付与され、無料で試用できます。クレジットが不足した場合はコンソールで共通残高をチャージできます。

📘 完全なドキュメント：Fish Model API →

リクエストボディフィールド

フィールド	型	必須	説明
`title`	string	はい	音色名。コンソールのリストで識別するために使用されます。
`voices`	string	はい	音声サンプルの HTTP(S) URL（単一の文字列であり、配列ではありません）。本インターフェースは multipart/バイナリアップロードをサポートしていないため、先に音声を任意の公開アクセス可能なオブジェクトストレージに配置してください。
`description`	string	いいえ	音色の説明。
`cover_image`	string	いいえ	カバー画像の HTTP(S) URL。
`tags`	string[]	いいえ	公開ライブラリ検索タグ。例：`["male","narration","zh"]`。
`texts`	string[]	いいえ	サンプルに対応する参照テキスト（発音の補正に使用）。
`enhance_audio_quality`	boolean	いいえ	学習前にサンプルの音質を強化するかどうか。
`generate_sample`	boolean	いいえ	学習完了後にサンプル音声を自動生成するかどうか。

音色モデルの詳細については、Fish 公式ドキュメントを参照してください。

作成された音色は長期的に公開保存され、他のユーザーが検索して使用する可能性があります。visibility を渡す必要はありません。private または unlist を渡した場合でも、現在のインターフェースではそれに応じて公開範囲は変更されません。

例：公開クローン音色を作成する

curl -X POST 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "title": "私のクローン音色",
    "description": "ポッドキャスト録音の一部を使用してクローンした中国語音色",
    "voices": "https://example.com/sample-voice.mp3",
    "cover_image": "https://cdn.acedata.cloud/e724d7f13d.png"
  }'

注意：voices は文字列（単一の音声 URL）である必要があり、配列ではありません。["..."] として渡すとアップストリームに拒否されます。.mp3 または .wav 拡張子を持つ、公開ダウンロード可能な直リンクの使用を推奨します。

成功時のレスポンスでは、Fish プラットフォームの ModelEntity オブジェクトが直接返されます（以下の例は当社でテスト済みの最小限の使用可能な音色であり、読みやすさのため一部の長いフィールドを省略しています）：

{
  "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
  "type": "tts",
  "title": "copilot-smoke-test",
  "description": "smoke test from api.acedata.cloud",
  "cover_image": "coverimage/e5c6db52c3ed417f9cb2e5a33fb04667",
  "train_mode": "fast",
  "state": "trained",
  "tags": [],
  "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",
  "updated_at": "2026-05-10T03:52:55.601000Z",
  "languages": ["zh"],
  "visibility": "public",
  "default_text": "師匠、[毅然とした口調で]私はもうこの山での冷え切った日々に本当にうんざりしています！...",
  "like_count": 0,
  "mark_count": 0,
  "shared_count": 0,
  "task_count": 0,
  "author": {
    "_id": "780f2b2f862d41a08c0507bbbda77eb6",
    "nickname": "Penny Conrad",
    "avatar": "avatars/780f2b2f862d41a08c0507bbbda77eb6.jpg"
  }
}

_id は後続の Fish TTS API における reference_id フィールドの値として使用でき、このクローン音色を使用した音声合成に用いられます。作成に成功した音色は公開保存され、Fish Model Query API の self=true を使用して、現在の呼び出しユーザーが本プラットフォーム経由で作成した音色を照会できます。self=true はリストの絞り込みのみを行い、他のユーザーによるこの音色の使用を制限しません。

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "こんにちは、これは私が先ほど作成したクローン音色を使用して合成した音声です。",
    "reference_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
    "format": "mp3"
  }'

サンプル要件

経験則（アップストリームと同様であり、Fish 公式ドキュメントを参照できます）：

長さは30秒以上、5分以内が最も効果的です。10分を超えても限界的な効果は大きくありません。
サンプリングレートは16 kHz以上で、モノラルまたはステレオのいずれでも構いません。
内容はできるだけクリーンにしてください：背景音楽、残響、明らかな環境ノイズがなく、同一話者であること。
形式は mp3 / wav を推奨します。

サンプル品質に自信がない場合は、enhance_audio_quality: true を同時に渡して、アップストリームに先に音質強化を行わせることができます。

料金説明

音色クローンモデル（POST /fish/model）の作成は無料で、料金は一切かかりません。音色の照会インターフェース（Fish Model Query、Fish Model Get）も同様に課金されません。料金が発生するのは、その後 Fish TTS を呼び出して音声を合成する際の使用量のみです。

エラー処理

400 token_mismatched：リクエストパラメータが不足しているか不正です（最も多いのは、voices が URL ではない、または配列として渡されているケースです）。
400：参照音声をダウンロードできない、長さが短すぎる、または形式を認識できない場合は、音声 URL とファイル形式を確認してください。
401 invalid_token：認証 token が存在しないか無効です。
429 too_many_requests：アカウントのレート制限が発動しています。
500 api_error：サーバー内部エラーです。

エラーレスポンスの例：

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "voices is required and must be an HTTP(S) URL pointing to an audio file"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

結論

このインターフェースを呼び出すには、公開アクセス可能なサンプル音声 URL を用意し、それを voices フィールドに入れるだけで _id を取得できます。その後、それを /fish/tts の reference_id に渡せば、エンドツーエンドの「クローン → 合成」が完了します。よくある落とし穴は、voices が文字列でなければならず、配列にはできないことです。

MCP を通じた音色の作成と再利用

Fish MCP では、次を呼び出します。 fish_create_model(title="私の音色", voices="https://example.com/authorized-voice.wav")。 voices は単一の HTTP(S) 音声 URL です。description、cover_image、tags、 texts、enhance_audio_quality、generate_sample も渡せます。このツールは公開音色を長期間保存し、他のユーザーが見つけて使用する可能性があります。処理および公開の許可を得た音声素材のみを使用してください。ツールには非公開または非公開設定のオプションはありません。作成成功時に返される _id は fish_generate_audio の reference_id に使用され、fish_list_models(self=true) では自分が保存した音色を照会できます。一度だけ参照音声を使用する場合は、fish_generate_audio の references を使用し、長期的な音色を作成する必要はありません。

はじめに

AIチャット

AI画像

AI動画

AIオーディオ

ウェブ＆データ

CAPTCHA

アイデンティティ

Coding

その他のガイド

Fish Model Create API 連携説明

申請フロー

リクエストボディフィールド

例：公開クローン音色を作成する

サンプル要件

料金説明

エラー処理

結論

MCP を通じた音色の作成と再利用

​申請フロー

​リクエストボディフィールド

​例：公開クローン音色を作成する

​サンプル要件

​料金説明

​エラー処理

​結論

​MCP を通じた音色の作成と再利用

申請フロー

リクエストボディフィールド

例：公開クローン音色を作成する

サンプル要件

料金説明

エラー処理

結論

MCP を通じた音色の作成と再利用