Skip to main content
Fish Tasks API の主な機能は、Fish Audios Generation API によって生成されたタスクIDを入力することで、そのタスクの実行状況を照会することです。 この記事では、Fish Tasks API の接続説明を詳しく紹介し、簡単に統合し、この API の強力な機能を十分に活用できるようにします。Fish Tasks API を使用することで、Fish Audios Generation API のタスク実行状況を簡単に照会できます。

​
申請プロセス

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

​
リクエスト例

Fish Tasks API は、Fish Audios Generation API の結果を照会するために使用できます。Fish Audios Generation API の使用方法については、ドキュメント Fish Videos Generation API を参照してください。 Fish Audios Generation API サービスから返されたタスクIDを例に、どのようにこの API を使用するかを示します。タスクID：2725a2d3-f87e-4905-9c53-9988d5a7b2f5 があると仮定し、次にタスクIDを渡す方法を示します。

​
タスク例の画像

​
リクエストヘッダーとリクエストボディの設定

Request Headers には以下が含まれます：
  • accept：JSON形式のレスポンス結果を受け取ることを指定し、ここには application/json を記入します。
  • authorization：APIを呼び出すためのキーで、申請後に直接ドロップダウンから選択できます。
Request Body には以下が含まれます：
  • id：アップロードされたタスクID。
  • action：タスクの操作方法。
設定は以下の図のようになります：

​
コード例

ページの右側には、さまざまな言語のコードが自動的に生成されていることがわかります。以下の図のように：

一部のコード例は以下の通りです：

​
CURL

​
レスポンス例

リクエストが成功すると、API はこのタスクの詳細情報を返します。例えば：
返された結果には複数のフィールドがあり、request フィールドはタスクを開始したときの request body であり、response フィールドはタスク完了後に返される response body です。フィールドの説明は以下の通りです。
  • id：このタスクを生成するための ID で、今回の生成タスクを一意に識別します。
  • request：タスク内のリクエスト情報を照会します。
  • response：タスク内の返却情報を照会します；最終的に成功した場合、その中の cost.amount は今回の合成で実際に差し引かれたクレジットです。
  • created_at：タスク作成時間、Unix タイムスタンプ（秒、浮動小数点）。
  • started_at：タスク開始実行時間、Unix タイムスタンプ（秒、浮動小数点）。
  • finished_at：タスク完了時間、Unix タイムスタンプ（秒、浮動小数点）。タスクが未完了の場合、このフィールドは返されません。
  • elapsed：タスク実行にかかった時間、単位は秒（浮動小数点、3 桁の小数点以下を保持）。タスクが未完了の場合、このフィールドは返されません。

​
バッチ照会操作

これは複数のタスクIDに対してタスクの詳細を照会するもので、上記とは異なり、action を retrieve_batch に設定する必要があります。 Request Body には以下が含まれます：
  • ids：アップロードされたタスクIDの配列。
  • action：タスクの操作方法。
設定は以下の図のようになります：

​
コード例

ページの右側には、さまざまな言語のコードが自動的に生成されていることがわかります。以下の図のように：

一部のコード例は以下の通りです：

​
レスポンス例

リクエストが成功すると、API は今回のすべてのバッチタスクの具体的な詳細情報を返します。例えば：
返却結果には複数のフィールドが含まれており、itemsはバッチタスクの具体的な詳細情報を含んでいます。各タスクの具体的な情報は上記のフィールドと同じです。
  • items、バッチタスクのすべての具体的な詳細情報。それは配列であり、各配列の要素は上記の単一タスクの返却結果の形式と同じです。
  • count、ここでのバッチクエリタスクの数。

​
CURL

​
エラー処理

APIを呼び出す際にエラーが発生した場合、APIは対応するエラーコードと情報を返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足しているか無効である可能性があります。
  • 401 invalid_token：未承認、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、Fish Tasks APIを使用して単一またはバッチタスクのすべての具体的な詳細情報を取得する方法を理解しました。この文書がAPIの接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。