_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 の署名クエリ文字列を削除して読みやすくしています):
_id を Fish TTS の reference_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:サーバー内部エラーです。
400 Model not found を返します(実測):
結論
音色_id が分かっている場合は、このインターフェースを使って完全な ModelEntity を取得します。最も一般的な使い方は:(1) samples[].audio を試聴する、(2) _id を /fish/tts の reference_id に渡して合成を完了させることです。タイトルやタグしかない場合は、まず Fish Model Query で検索してください。
