Skip to main content
本インターフェースは Fish Audio 公式 Model API に基づいており、_id による単一クローン音色の完全な詳細を照会するために使用されます。アドレスは GET https://api.acedata.cloud/fish/model/{id} です。
音色の作成については Fish Model Create API を参照してください;ページネーション検索については Fish Model Query API を参照してください。

申請プロセス

Fish Model API を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、保管してください。 まだログインまたは登録していない場合、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます;クレジットが不足した場合は コンソール で一般残高をチャージできます。
📘 完全なドキュメント:Fish Model API →

パスパラメータ

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

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

返却(実測、samples[].audio の署名クエリ文字列を削除して読みやすくしています):
取得した _idFish TTSreference_id に直接渡すことで、同じ音色の音声を合成できます:

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

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

応答フィールド(抜粋)

課金説明

本インターフェースは課金されません——IDによる単一音色の詳細照会は無料操作です。音色の作成(Fish Model Create)も無料で、費用は 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 を返します(実測):
返却:
エラー応答の例:

結論

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